DjangoAdmin DevandClaude
a6e094378c
- src/core/exceptions.py：BizError/NotFoundError/PermissionDeniedError - 全局异常处理器接入 BizError → R.failed（含事务回滚语义） - src/common/base_repository.py：泛型 CRUD 仓储基类 - src/common/base_service.py：服务基类（入参数据/出参数据范式） 【验收】BizError 端到端转换为 R.failed（code=403/ok=false）；应用启动 Co-Authored-By: Claude <noreply@anthropic.com>
96 lines
2.8 KiB
Python
96 lines
2.8 KiB
Python
"""
|
|
全局异常处理模块
|
|
=============================================================
|
|
|
|
注册 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
|
|
from src.core.exceptions import BizError
|
|
|
|
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(BizError)
|
|
def handle_biz_error(e):
|
|
"""
|
|
业务异常处理器
|
|
|
|
业务代码 raise BizError(...) 时统一转换为 R.failed 响应，
|
|
并回滚当前事务（teardown_request 处理）。
|
|
"""
|
|
logger.info(f"业务异常: {e.msg} (code={e.code})")
|
|
return R.failed(msg=e.msg, code=e.code, data=e.data, **e.kwargs)
|
|
|
|
@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("全局异常处理器注册成功")
|