Bottle 默认内置服务器仅适用于开发调试,生产环境必须使用Gunicorn等专业WSGI服务器;需手动处理JSON解析、路径/查询参数区分、错误响应JSON化及缺失功能补全。

为什么直接用 bottle.run() 会卡住生产环境
因为 bottle.run() 默认启动的是单线程、无超时、不支持 keep-alive 的内置 WSGI 服务器,只适合开发调试。一上生产,高并发下会阻塞、无法复用连接、甚至被反向代理(如 Nginx)断连。
实操建议:
立即学习“Python免费学习笔记(深入)”;
将测试、lint、构建和文档流程编码为命名的Python会话,以便人类和代理每次运行相同的workflow。
- 开发阶段可继续用
bottle.run(host='localhost', port=8080, debug=True),但务必加debug=True才能看错误详情 - 上线前必须换成专业 WSGI 服务器,比如
gunicorn:运行gunicorn --bind :8080 --workers 2 myapp:app,其中myapp:app指向你定义的Bottle()实例 - 避免在代码里写
if __name__ == '__main__': run(...)—— 这会让 gunicorn 导入时意外触发服务启动
如何让 JSON 接口自动处理空 body 和 content-type
Bottle 不会自动解析空请求体,也不强制校验 Content-Type: application/json,导致 request.json 在 POST 空体或错标类型时返回 None,容易引发 AttributeError。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 始终用
request.json is not None判空,而不是直接访问键:data = request.json or {} - 加一层装饰器统一处理解析失败:
def require_json(f): def wrapper(*args, **kwargs): if not request.json: return {'error': 'invalid json body'} return f(*args, **kwargs) return wrapper @route('/api/user', method='POST') @require_json def create_user(): name = request.json.get('name') return {'id': 1, 'name': name} - 不要依赖客户端发对
Content-Type;Bottle 的request.json只认application/json,其他如text/plain或缺失 header 都会失效
路由参数和查询参数怎么区分才不混淆
route('/user/<int>') </int> 中的 uid 是路径参数,request.query.name 才是查询参数(即 URL ? 后面的)。新手常把两者混用,比如想用 request.query.uid 去取 /user/123 里的 123,结果取不到。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 路径参数用于资源标识(必须存在、不可选),如
/posts/<int></int>;查询参数用于过滤或分页(可选),如/posts?limit=10&offset=0 - 类型约束要显式写:
<int></int>会自动转成整数并 404 未匹配项;<path></path>可捕获带斜杠的路径段 - 如果需要同时接收同名参数(比如
/user/123?uid=456),Bottle 会优先用路径参数值,request.query.uid仍可读,但逻辑上不该这样设计
怎样让错误响应统一成 JSON 格式
Bottle 默认 404/500 返回 HTML 页面,微服务要求所有错误也走 JSON,否则前端难处理。但 error() 装饰器只接管 HTTP 错误码,不处理未捕获异常。
实操建议:
立即学习“Python免费学习笔记(深入)”;
- 用
@error(404)和@error(500)分别返回 JSON:@error(404) def error404(error): return {'error': 'not found'} @error(500) def error500(error): return {'error': 'server error'} - 全局捕获未处理异常:在应用开头加
app.catchall = False,再用install()注册一个自定义钩子,或更简单——用 try/except 包裹每个 handler - 注意:Bottle 的
abort(400, 'bad request')会触发@error(400),但默认没注册该码,需手动补全
hook('before_request') 统一鉴权、是否引入 bottle-cors 插件。越轻量,越得清楚每一行代码落在哪条执行路径上。

















