Flask部署Docker时render_template异常，/books路由报内部错误

• 触发/books路由500内部错误的直接原因是Docker构建流程遗漏了模板目录文件。
• 原有Dockerfile仅执行ADD books.py /将主程序文件拷贝到容器根目录，本地项目下的templates模板文件夹从未被同步到容器环境。
• Flask的render_template函数默认从应用代码所在目录的同级templates子目录查找模板文件，容器内缺失该目录及对应的index.html模板时，会直接抛出找不到模板的异常，最终返回内部服务器错误。
• 首页路由访问正常的逻辑非常明确：该路由返回的是硬编码HTML字符串，完全不依赖模板文件加载，因此不受上述目录缺失问题影响，和你实际测试的现象完全吻合。

1. 调整Dockerfile的文件拷贝逻辑，将所有项目文件同步进容器，从根源上避免单文件拷贝带来的目录遗漏问题，修正后的Dockerfile参考如下：

FROM python:3
# 指定固定工作目录，避免文件散落在系统根目录造成路径混乱
WORKDIR /app
# 将本地当前项目目录下的所有文件（含books.py、templates文件夹）拷贝到容器内的工作目录
ADD . /app
# 批量安装项目依赖
RUN pip install flask flask_restful requests
EXPOSE 3333
CMD ["python", "./books.py"]

2. 日常开发排障优化建议：
   • 本地开发阶段可以临时在Flask启动代码中开启debug模式，修改books.py的启动行：app.run('0.0.0.0', 3333, debug=True)，触发错误时会直接在浏览器展示具体的错误堆栈，无需翻找容器日志就能快速定位问题。
   • 容器启动后，可以通过docker exec -it 运行中的容器ID ls /app/templates命令校验模板目录是否成功同步，确认文件路径匹配Flask的默认查找规则。

提示：你现有代码中的Flask应用初始化逻辑app = Flask(__name__)完全符合默认路径规则，只要templates文件夹和books.py处于同一目录层级，Flask就能自动定位到模板文件，无需额外修改代码中的模板查找路径。

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