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:
co-authored by
Claude
parent
8691412ec6
commit
92130ef070
+18
-126
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user