Flask中__init__.py导入模块时出现500内部服务器错误的解决办法

问题背景 #

• Python版本：3.10.6
• 初始__init__.py运行正常，代码如下：

#!/usr/bin/env python3

from flask import Flask, render_template, request
app = Flask(__name__)

@app.route('/testurl')
def testurl():
    return render_template('index.html')

@app.route('/from_client', methods=['POST'])
def from_client():
    request_data = request.get_json()
    return request_data

if __name__ == '__main__':
    app.run()

• 项目目录结构：

flaskApp
---- flaskApp
    ---- __init__.py
    ---- modules
        ---- mymodules.py
    ---- static
        ---- css
        ---- img
        ---- js
    ---- templates
        ---- index.html
---- flaskapp.wsgi

• 修改__init__.py导入modules/mymodules.py后出现500错误，修改后代码：

#!/usr/bin/env python3

from flask import Flask, render_template, request
from modules import mymodules
app = Flask(__name__)

@app.route('/testurl')
def testurl():
    return render_template('index.html')

@app.route('/from_client', methods=['POST'])
def from_client():
    request_data = request.get_json()
    data_id = mymodules.somecode(request_data)
    return data_id

if __name__ == '__main__':
        app.run()

• 尝试添加sys.path.append未解决问题。

解决步骤 #

1. 修正模块导入方式 #

由于modules与__init__.py处于同一层级目录，可通过两种方式调整导入逻辑：

• 相对导入（推荐包结构下使用）：
  将导入语句改为：

  from .modules import mymodules
  

  注：本地直接运行__init__.py时可能报错，需改用flask run命令启动，或设置PYTHONPATH环境变量；WSGI部署环境下此方式有效。
• 手动添加项目路径：
  在__init__.py开头添加代码，将当前文件所在目录加入Python路径：

  import sys
  from pathlib import Path
  # 获取当前文件所在目录（即内层flaskApp目录）
  project_dir = Path(__file__).parent
  sys.path.append(str(project_dir))
  

  之后保留from modules import mymodules即可。

2. 排查mymodules.py自身问题 #

500错误可能源于自定义模块本身的问题：

• 检查mymodules.py是否存在语法错误
• 确认somecode函数逻辑，比如是否处理了request_data为None的情况
• 开启Flask调试模式查看详细错误：
  修改app.run()为：

  app.run(debug=True)
  

  调试模式会直接展示错误堆栈，精准定位问题点。

3. 验证WSGI配置正确性 #

若通过WSGI部署（如Apache），需确保flaskapp.wsgi正确设置路径：

import sys
# 路径指向外层flaskApp目录
sys.path.insert(0, '/实际路径/flaskApp')

from flaskApp import app as application

4. 检查文件权限 #

确保服务器进程（如www-data）拥有读取modules目录及mymodules.py文件的权限，权限不足也会触发500错误。

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