Flask应用命令行与mod_wsgi部署导入冲突问题求助

问题根源 #

两种运行环境下Python的模块搜索路径逻辑不同：

• 命令行直接启动时，rocket_launcher作为子模块运行，相对导入有效，但绝对导入会误将其识别为顶层模块，导致找不到目标属性。
• mod_wsgi部署时，rocket_launcher被视为顶层模块，相对导入因无法识别父包而失败。

解决方案 #

方法1：统一相对导入+规范命令行启动方式 #

如果bp是rocket_launcher包内的模块/变量，直接在__init__.py的工厂函数中使用相对导入：

from . import bp

然后改用Flask官方推荐的命令行启动方式：

1. 在项目根目录（rocket_launcher_flask）创建.flaskenv文件，写入：

FLASK_APP=rocket_launcher
FLASK_ENV=development

2. 打开命令行进入rocket_launcher_flask目录，执行：

flask run

这种方式下Flask会自动处理模块路径，相对导入在两种环境下都能正常工作。

方法2：动态添加项目路径，统一绝对导入 #

在__init__.py开头添加代码，将项目根目录加入Python模块搜索路径：

import sys
import os
# 获取项目根目录（rocket_launcher_flask的绝对路径）
project_root = os.path.abspath(os.path.dirname(os.path.dirname(__file__)))
if project_root not in sys.path:
    sys.path.insert(0, project_root)

之后在工厂函数中统一使用绝对导入：

from rocket_launcher import bp

该方法无需修改启动命令，可同时兼容两种运行环境。

方法3：根据环境动态选择导入逻辑 #

在__init__.py的工厂函数中，通过环境标识判断导入方式：

import sys
import os
from flask import Flask

def create_app():
    app = Flask(__name__)
    # 判断是否为Flask命令行启动环境
    if sys.argv[0].endswith('flask') or os.environ.get('FLASK_ENV'):
        from . import bp
    else:
        from rocket_launcher import bp
    app.register_blueprint(bp)
    # 其他应用配置代码
    return app

这种方式可灵活适配不同启动场景，需确保环境标识的判断逻辑准确。

内容的提问来源于stack exchange，提问作者user1045680