Python 搭建 HTTP 服务器速成指南：从 `http.server` 到 Flask，顺带搞定静态资源与模板渲染！

在客户端-服务器模型中，HTTP 服务器作为核心组件，通过 HTTP/HTTPS 协议与客户端通信。下面依次演示：

用标准库 http.server 快速拉起 POST/GET 服务
用 Flask 重构并加入模板渲染、静态资源
提供调试、部署小贴士与常见坑排雷

💡 想让指标可衡量、团队节奏更透明？「开发任务管理系统 KPI」提示词可帮你基于 AI 超级提示词，快速制定与业务成果对齐的 KPI，兼顾用户参与度与交付质量！

一、REST 与 HTTP 请求/响应速览 📡

组件	说明
URL	资源地址
Method	GET（查）/ POST（改/增）/ PUT / DELETE 等
Headers	Content-Type、Authorization 等元数据
Body	JSON、表单、二进制等载荷

响应：状态码 + Headers + Body（JSON 最常用）

二、用 `http.server` 搭建最小 POST/GET 服务 🧪

① 目录结构

mini_http/

├── server.py

└── README.md

② server.py

from http.server import HTTPServer, BaseHTTPRequestHandler
import json

data_store = {}   # 内存假数据库

class MyHandler(BaseHTTPRequestHandler):
    def do_POST(self):
        if self.path == "/api/post":
            length = int(self.headers["Content-Length"])
            payload = json.loads(self.rfile.read(length))
            data_store[payload["id"]] = payload
            self.send_response(201)
            self.send_header("Content-type", "application/json")
            self.end_headers()
            self.wfile.write(json.dumps({"status": "ok"}).encode())

    def do_GET(self):
        if self.path.startswith("/api/get/"):
            key = self.path.split("/")[-1]
            record = data_store.get(key)
            if record:
                self.send_response(200)
                self.send_header("Content-type", "application/json")
                self.end_headers()
                self.wfile.write(json.dumps(record).encode())
            else:
                self.send_response(404)
                self.end_headers()

if __name__ == "__main__":
    host, port = "localhost", 8000
    print(f"Serving on http://{host}:{port}")
    HTTPServer((host, port), MyHandler).serve_forever()

③ 启动 & 测试

python server.py
# 另开终端
curl -X POST http://localhost:8000/api/post \
     -H "Content-Type: application/json" \
     -d '{"id":"test","key":"value"}'
curl http://localhost:8000/api/get/test
# → {"key": "value"}

🛠️ 写完处理器别忘了跑「代码优化」提示词，一键诊断慢查询与重复请求，让接口响应提速 30 %！

三、Flask 重构：更优雅的路由与模板渲染 🎨

① 安装 & 项目结构

pip install flask
mkdir flask_http && cd flask_http
├── app.py
├── templates/
│   └── index.html
└── static/
    ├── style.css
    └── app.js

② app.py

from flask import Flask, request, jsonify, render_template

app = Flask(__name__)
store = {}

@app.route("/api/post", methods=["POST"])
def api_post():
    data = request.get_json()
    store[data["id"]] = data
    return jsonify({"status": "ok"}), 201

@app.route("/api/get/<uid>")
def api_get(uid):
    return jsonify(store.get(uid, {"error": "Not found"})), (200 if uid in store else 404)

@app.route("/")
def index():
    # 把内存数据渲染到页面
    return render_template("index.html", records=store)

if __name__ == "__main__":
    app.run(debug=True)

③ templates/index.html

<!doctype html>
<html lang="en">
<head>
    <meta charset="utf-8">
    <title>HTTP Server Demo</title>
    <link rel="stylesheet" href="{{ url_for('static', filename='style.css') }}">
</head>
<body>
    <h1>Data Store</h1>
    <ul>
        {% for uid, rec in records.items() %}
        <li>{{ uid }}: {{ rec }}</li>
        {% endfor %}
    </ul>
    <script src="{{ url_for('static', filename='app.js') }}"></script>
</body>
</html>

④ static/style.css

body{font-family:Arial,Helvetica,sans-serif;background:#f7f7f7;margin:40px}
h1{color:#333}
ul{list-style:none;padding:0}
li{background:#fff;margin:5px 0;padding:8px;border-radius:4px}

⑤ 启动 & 访问

flask --app app run --debug
# 浏览器 http://127.0.0.1:5000

四、调试与自动重载 🔧

开发阶段始终加 --debug 参数，代码变动自动重启
使用 flask shell 快速验证模型函数
通过 app.logger.info(...) 输出日志，控制台实时查看

五、生产部署小贴士 🚀

WSGI 服务器

pip install gunicorn
gunicorn -w 4 -b 0.0.0.0:8000 app:app

Nginx 反向代理
将静态文件交由 Nginx 处理，减少 Flask 压力
环境变量管理
使用 python-dotenv 把敏感配置放 .env，避免硬编码

六、常见坑排雷 ⚠️

问题	解决
`http.server` 无法解析 JSON	需手动 `json.loads(self.rfile.read(...))`
Flask 模板/静态文件 404	确保放在 `templates/` & `static/` 目录
跨域阻塞	开发期可用 `flask-cors`：`CORS(app)`
自动重载不生效	检查是否用了 `app.run(debug=True)` 且直接 `python app.py`

七、一键单元测试（Flask 示例）🧪

# test_app.py
import unittest, json
from app import app

class FlaskTest(unittest.TestCase):
    def setUp(self):
        self.client = app.test_client()

    def test_post_get_flow(self):
        # POST
        resp = self.client.post("/api/post", 
                                data=json.dumps({"id": "t1", "key": "val"}),
                                content_type="application/json")
        self.assertEqual(resp.status_code, 201)
        # GET
        resp = self.client.get("/api/get/t1")
        self.assertEqual(resp.json["key"], "val")

if __name__ == "__main__":
    unittest.main()

运行：

python test_app.py

八、结语 🎯

从标准库 http.server 到 Flask，你已成功：

✅ 搭建支持 POST/GET 的 HTTP 服务
✅ 返回 JSON 与 HTML 两种表示
✅ 管理模板 & 静态资源
✅ 编写单元测试并开启调试

先用「代码生成」快速产出 SDK 与错误重试逻辑，再用 KPI 面板持续监控请求延迟、错误率和单元测试通过率，你的 HTTP 服务器将更快、更稳地抢占市场 🚀！

原文链接: https://www.xingyulei.com/post/py-http-server/index.html

Python 搭建 HTTP 服务器速成指南：从 `http.server` 到 Flask，顺带搞定静态资源与模板渲染！

文章目录

一、REST 与 HTTP 请求/响应速览 📡

二、用 `http.server` 搭建最小 POST/GET 服务 🧪

① 目录结构

② server.py

③ 启动 & 测试

三、Flask 重构：更优雅的路由与模板渲染 🎨

① 安装 & 项目结构

② app.py

③ templates/index.html

④ static/style.css

⑤ 启动 & 访问

四、调试与自动重载 🔧

五、生产部署小贴士 🚀

六、常见坑排雷 ⚠️

七、一键单元测试（Flask 示例）🧪

八、结语 🎯

热门API

最新文章

Python 搭建 HTTP 服务器速成指南：从 `http.server` 到 Flask，顺带搞定静态资源与模板渲染！

文章目录

一、REST 与 HTTP 请求/响应速览 📡

二、用 http.server 搭建最小 POST/GET 服务 🧪

① 目录结构

② server.py

③ 启动 & 测试

三、Flask 重构：更优雅的路由与模板渲染 🎨

① 安装 & 项目结构

② app.py

③ templates/index.html

④ static/style.css

⑤ 启动 & 访问

四、调试与自动重载 🔧

五、生产部署小贴士 🚀

六、常见坑排雷 ⚠️

七、一键单元测试（Flask 示例）🧪

八、结语 🎯

热门API

最新文章

二、用 `http.server` 搭建最小 POST/GET 服务 🧪