refactor: P2 core+common 建设(应用工厂/扩展/工具层迁入 src/)
【结构】 - src/core/:database/response/jwt/password/security/redis_client/mail/scheduler - src/common/:base_model/base_db/forms(base_form+fields)/constants/utils - src/models_registry.py:模型聚合器(Flask-Migrate 全量表识别) 【绞杀者 shim】extensions/、utils/、application/constants|forms|models 打兼容转发 【兼容修复】应用工厂抽取至 application/factory.py(P2 前置,P1 已完成) 【基线修复】application/models(25) + middleware(7) 原被嵌套 .gitignore(*) 误排除出版本库,已补入(base_model/base_db 现为 shim,原版在 src/common/) 【登记既有缺陷】 1. flask db CLI 因 .env FLASK_VERSION 与 --version 冲突报错 → Makefile 已加 FLASK_SKIP_DOTENV=1 2. 本机 Redis 未设密码但 REDIS_AUTH=True,/captcha 报 AUTH 错误(环境问题) 【验收】22 模型表全量识别;src/ flake8 零告警;pytest 5 passed;应用启动; /login 表单校验、/user/page 鉴权拦截冒烟正常 Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude
parent
92130ef070
commit
658ee6d596
@@ -0,0 +1,83 @@
|
||||
"""
|
||||
全局异常处理模块
|
||||
=============================================================
|
||||
|
||||
注册 Flask errorhandler,将所有 HTTP 错误和未捕获异常
|
||||
统一转为 R.failed() JSON 响应,避免前端收到 HTML 错误页导致解析崩溃。
|
||||
|
||||
处理范围:
|
||||
- 400:请求参数错误
|
||||
- 401:未授权
|
||||
- 403:权限不足
|
||||
- 404:资源不存在
|
||||
- 405:请求方法不允许
|
||||
- 500:服务器内部错误
|
||||
- Exception:兜底,捕获所有未预期异常
|
||||
"""
|
||||
|
||||
import logging
|
||||
import traceback
|
||||
|
||||
from flask import request
|
||||
from werkzeug.exceptions import HTTPException
|
||||
|
||||
from utils import R
|
||||
|
||||
logger = logging.getLogger(__name__)
|
||||
|
||||
|
||||
def register_error_handlers(app):
|
||||
"""
|
||||
注册全局异常处理器
|
||||
|
||||
确保所有 HTTP 错误和未捕获异常都返回标准 JSON 响应。
|
||||
|
||||
Args:
|
||||
app: Flask 应用实例
|
||||
"""
|
||||
|
||||
@app.errorhandler(400)
|
||||
def bad_request(e):
|
||||
return R.failed(msg="请求参数错误", code=400), 400
|
||||
|
||||
@app.errorhandler(401)
|
||||
def unauthorized(e):
|
||||
return R.failed(msg="未授权,请重新登录", code=401), 401
|
||||
|
||||
@app.errorhandler(403)
|
||||
def forbidden(e):
|
||||
return R.failed(msg="权限不足", code=403), 403
|
||||
|
||||
@app.errorhandler(404)
|
||||
def not_found(e):
|
||||
return R.failed(msg="请求的资源不存在", code=404), 404
|
||||
|
||||
@app.errorhandler(405)
|
||||
def method_not_allowed(e):
|
||||
return R.failed(msg="请求方法不允许", code=405), 405
|
||||
|
||||
@app.errorhandler(500)
|
||||
def internal_error(e):
|
||||
logger.error(
|
||||
f"服务器内部错误, method: {request.method}, path: {request.path}, "
|
||||
f"error: {str(e)}",
|
||||
exc_info=True
|
||||
)
|
||||
msg = f"服务器内部错误: {str(e)}" if app.debug else "服务器内部错误"
|
||||
return R.failed(msg=msg, code=500), 500
|
||||
|
||||
@app.errorhandler(Exception)
|
||||
def handle_exception(e):
|
||||
# HTTPException 子类(如 abort(403))已有专用 handler,不重复处理
|
||||
if isinstance(e, HTTPException):
|
||||
return e.get_response()
|
||||
|
||||
# 非HTTP异常:未知运行时异常
|
||||
logger.error(
|
||||
f"未捕获异常, method: {request.method}, path: {request.path}, "
|
||||
f"error: {traceback.format_exc()}"
|
||||
)
|
||||
msg = f"服务器内部错误: {str(e)}" if app.debug else "服务器内部错误"
|
||||
return R.failed(msg=msg, code=500), 500
|
||||
|
||||
logger.info("全局异常处理器注册成功")
|
||||
Reference in New Issue
Block a user