chore: P1 验证通过 + 应用工厂抽取(修复循环导入)

- application/factory.py:应用工厂独立成模块,application 包保持轻量
  (修复 utils→application.constants 触发全量导入的循环依赖,P2 前置改造)
- app.py 改为 from application.factory import create_app
- tests/conftest.py:新增 flask_app 上下文 fixture
- test_response.py:R.ok/failed 在应用上下文中测试
- .flake8:修复 extend-ignore 行内注释导致 flake8 解析失败

验证:
- pytest 5 passed
- 应用完整构建 OK(MySQL/Redis 就绪)
- flake8 存量基线 154 条(F401×111 / E402×36 / 其余 7)已登记

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
DjangoAdmin Dev
2026-08-07 12:22:56 +08:00
co-authored by Claude
parent 8691412ec6
commit 92130ef070
7 changed files with 238 additions and 146 deletions
+18 -126
View File
@@ -40,130 +40,22 @@
# +======================================================================
"""
应用工厂模块
负责创建和配置 Flask 应用实例
application 包
=============================================================
Flask 应用核心包。
包结构:
- factory.py 应用工厂(create_app)
- constants/ 常量定义
- forms/ 表单验证
- middleware/ 请求/响应中间件
- models/ 数据模型
- services/ 业务逻辑
- views/ 路由控制器
说明:
应用工厂独立于 factory.py,保持本包导入轻量,避免包初始化时
触发全量导入(修复循环导入,支持单元测试与模块级导入)。
重构方向:本包后续整体迁移至 src/(见重构方案-v2.md)。
"""
import os
from flask import Flask
from flask_cors import CORS
from werkzeug.middleware.proxy_fix import ProxyFix
from application.middleware.transaction import register_transaction
from application.middleware import register_middleware
from application.middleware.error_handler import register_error_handlers
from application.middleware.op_log import register_operation_log
from application.views import register_blueprint
from config import DatabaseConfig, REDIS_URL
from extensions import register_extends
from utils.json import JSONEncoder
def create_app():
"""
创建并配置 Flask 应用实例
配置流程:
1. 创建 Flask 核心对象
2. 配置 Redis 连接
3. 加载数据库配置
4. 设置 JSON 序列化器
5. 配置跨域资源共享
6. 初始化数据库
7. 初始化 Redis 缓存
8. 注册路由蓝图
9. 初始化第三方扩展
10. 注册中间件
Returns:
Flask: 配置完成的应用实例
"""
# ============================================================
# 创建 Flask 核心对象
# ============================================================
app = Flask(
__name__,
template_folder='../templates',
static_folder='../static'
)
# ============================================================
# Redis 配置(用于缓存和会话存储)
# ============================================================
app.config['REDIS_URL'] = REDIS_URL
# ============================================================
# 加载数据库配置
# ============================================================
app.config.from_object(DatabaseConfig)
# ============================================================
# 自定义 JSON 序列化器(支持 datetime 等特殊类型)
# ============================================================
app.json = JSONEncoder(app)
# ============================================================
# 跨域资源共享配置
# ============================================================
# 注意:origins="*" 与 supports_credentials=True 不兼容,
# 浏览器会拒绝携带凭证的通配符CORS响应。
# 配置了 CORS_ALLOWED_ORIGINS 时使用指定源(支持凭证),
# 未配置时使用通配符(不支持凭证)。
from config import CORS_ALLOWED_ORIGINS
if CORS_ALLOWED_ORIGINS:
allowed_origins = [origin.strip() for origin in CORS_ALLOWED_ORIGINS.split(',') if origin.strip()]
CORS(
app,
resources={r"/*": {"origins": allowed_origins}},
supports_credentials=True
)
else:
CORS(
app,
resources={r"/*": {"origins": "*"}},
supports_credentials=False
)
# ============================================================
# 可信代理配置(反向代理环境下获取真实客户端IP)
# ============================================================
# PROXY_NUM: 可信代理层数,默认0(无代理,不信任任何转发头)
# 设为1表示前面有1层可信代理(如Nginx),ProxyFix会从
# X-Forwarded-For 最右侧取1个IP作为真实客户端IP
proxy_num = int(os.getenv('PROXY_NUM', 0))
if proxy_num > 0:
app.wsgi_app = ProxyFix(app.wsgi_app, x_for=proxy_num, x_proto=proxy_num)
# ============================================================
# 注册操作日志自动记录中间件(必须在事务拦截器之前注册,
# 确保 after_request 中日志写入先于事务提交,日志随事务一起持久化)
# ============================================================
register_operation_log(app)
# ============================================================
# 注册 AOP 事务拦截器(核心:一行代码搞定所有事务)
# ============================================================
register_transaction(app)
# ============================================================
# 注册蓝图(路由分组管理)
# ============================================================
register_blueprint(app)
# ============================================================
# 初始化第三方扩展
# ============================================================
register_extends(app)
# ============================================================
# 注册中间件(请求/响应拦截处理)
# ============================================================
register_middleware(app)
# ============================================================
# 注册全局异常处理器(确保最后注册,能捕获所有环节异常)
# ============================================================
register_error_handlers(app)
return app