Flask Docker镜像无法找到基于类的配置文件问题求助

问题背景 #

本地虚拟环境（venv）中运行正常的Flask应用，打包为Docker镜像后出现以下错误：

werkzeug.utils.ImportStringError: import_string() failed for 'config.ProductionConfig'. Possible reasons are:

应用核心信息如下：

目录结构 #

|app
  |__init__.py
|main.py
|Dockerfile
|config.py

app/init.py #

app = Flask(__name__)

if app.config["ENV"] == "development":
    app.config.from_object("config.DevelopmentConfig")
elif app.config["ENV"] == "production":
    app.config.from_object('config.ProductionConfig')
else:
    app.config.from_object("config.DevelopmentConfig")

config.py（精简版） #

import os
from pymongo import MongoClient
import pymongo


class Config(object):
    DEBUG = False
    TESTING = False

class ProductionConfig():
    ...

class DevelopmentConfig(Config):
    ...

Dockerfile #

# Use the official lightweight Python image.
FROM python:3.10-slim

ENV PYTHONUNBUFFERED True
ENV PORT 8080

ENV APP_HOME /app
WORKDIR $APP_HOME
COPY . ./

RUN pip install --no-cache-dir -r requirements.txt

CMD exec gunicorn --bind :$PORT --workers 1 --threads 8 --timeout 0 main:app

排查与解决步骤 #

1. 修复配置类的继承缺陷 #

观察config.py中的ProductionConfig类，它未继承基类Config，这会导致导入时出现隐性错误：

# 错误写法
class ProductionConfig():
    ...

# 修正为
class ProductionConfig(Config):
    ...

本地环境可能因Python导入机制侥幸运行，但容器环境中会触发导入失败。

2. 替换字符串导入为直接类导入 #

将app/__init__.py中的字符串路径导入改为直接导入配置类，消除路径解析的不确定性：

from config import DevelopmentConfig, ProductionConfig

app = Flask(__name__)

env = app.config["ENV"]
app.config.from_object(DevelopmentConfig if env == "development" else ProductionConfig)

3. 显式设置容器内的Python模块路径 #

在Dockerfile中添加PYTHONPATH环境变量，确保工作目录被加入Python的模块搜索路径：

# 在COPY指令后添加
ENV PYTHONPATH=/app

尽管默认情况下当前工作目录会在Python路径中，但某些容器环境或gunicorn的运行上下文可能导致路径缺失，显式设置可规避此问题。

4. 明确指定Flask运行环境 #

在Dockerfile中显式设置FLASK_ENV，避免依赖默认值导致的环境判断错误：

# 生产环境设置
ENV FLASK_ENV=production
# 开发环境则改为
# ENV FLASK_ENV=development

这能确保app.config["ENV"]准确匹配对应的配置类。

5. 验证模块导入的可行性 #

临时修改Dockerfile的CMD指令，测试容器内是否能正常导入配置类：

CMD ["python", "-c", "from config import ProductionConfig; print('Import successful')"]

运行镜像后，若输出Import successful，说明模块导入正常，问题出在Flask配置加载的其他环节；若仍报错，需检查文件权限、requirements.txt是否包含所有依赖（如pymongo）。

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