Docker部署Flask导入自定义Python文件报ImportError问题排查

这个报错和Docker内的项目文件拷贝结构无关，核心原因是Python版本不兼容：

• 你的代码文件mBotControlPy/pathToNavigationConverting.py中执行了from mmap import ACCESS_DEFAULT导入，但mmap.ACCESS_DEFAULT是Python 3.7版本才加入标准库的常量，你当前使用的基础镜像是python:3.6.8-alpine，Python 3.6的内置mmap模块不存在这个属性，因此触发导入错误。

你可以通过临时启动容器直接复现问题，排除文件结构的影响：

# 基于你当前用的基础镜像启动临时容器
docker run --rm -it --entrypoint sh python:3.6.8-alpine
# 在容器内执行导入测试
python -c "from mmap import ACCESS_DEFAULT"

执行上述命令后会直接复现和你日志中完全一致的ImportError，即可确认问题来源。

选择以下任意一种方案即可解决问题：

• 方案1：升级基础镜像Python版本（推荐，改动最小）
  将Dockerfile中的基础镜像替换为Python 3.7及以上的稳定Alpine版本，例如：

  # 替换原有的FROM python:3.6.8-alpine行
  FROM python:3.9-alpine
  

  额外注意：你当前Dockerfile的CMD命令存在路径冗余问题，WORKDIR已经设置为/environmentservice，且代码已经全量拷贝到该目录下，不需要在执行路径前再加目录前缀，需要同步修改为：

  CMD ["python", "app.py"]
  

  修改完成后重新执行docker build构建镜像即可正常运行，无需调整业务代码。

• 方案2：修改代码兼容Python 3.6环境
  如果你因依赖限制必须使用Python 3.6版本，可以修改mBotControlPy/pathToNavigationConverting.py中的导入逻辑，手动补全兼容常量：

  # 替换原有的from mmap import ACCESS_DEFAULT行
  try:
      from mmap import ACCESS_DEFAULT
  except ImportError:
      # Python 3.6版本无该常量，对应默认取值为0
      ACCESS_DEFAULT = 0
  

• 方案3：排查第三方依赖版本冲突
  如果你没有主动编写过导入ACCESS_DEFAULT的代码，说明是你通过requirements.txt安装的某个第三方依赖版本过高、已经放弃对Python 3.6的兼容，这种情况要么按方案1升级Python版本，要么将对应依赖降级到支持Python 3.6的历史版本。

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