仅在Docker中启动Django应用时出现ModuleNotFoundError报错如何解决

错误诱因 #

该ModuleNotFoundError: No module named 'd'报错的核心原因是Django加载INSTALLED_APPS配置时，待导入的应用列表出现了异常值d，常见触发场景如下：

• 90%以上的概率是你在settings.py中配置了从环境变量读取INSTALLED_APPS并做拆分的逻辑，比如代码写为INSTALLED_APPS = os.getenv('INSTALLED_APPS', default_value).split(',')，但docker.env中对应配置项的格式和拆分逻辑不匹配：如果配置值中没有逗号，split(',')会将整个字符串拆分为单个字符的列表，若字符串首字符为d，Django就会尝试导入名为d的模块，触发报错。
• 本地运行正常是因为本地使用的配置（比如本地.env文件、或者本地直接写死的INSTALLED_APPS列表）没有格式问题，和容器内加载的配置不一致。
• 小概率场景为本地挂载到容器的代码目录下存在和容器Python版本不兼容的__pycache__缓存文件，导致配置加载异常。

修复步骤 #

1. 优先检查settings.py中INSTALLED_APPS的配置逻辑，确认是否存在从环境变量读取并拆分的代码。
2. 检查docker.env文件中INSTALLED_APPS的配置格式，确保和代码中的拆分逻辑匹配：如果用逗号作为分隔符，需要将所有应用名用逗号拼接，不要漏写分隔符，同时注意配置值不要加多余的单/双引号，避免拆分时将引号识别为内容的一部分。
3. 临时验证方案：将settings.py中的INSTALLED_APPS改为固定写死的列表，不读取环境变量，重新构建镜像启动，确认报错是否消失，快速定位问题根因。
4. 若为缓存问题，删除本地代码目录下所有__pycache__目录后重新启动容器即可。

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