AWS Elastic Beanstalk部署Flask应用调用render_template出现内部服务器错误

1 优先排查高频低级错误 #

• 依赖配置文件名拼写错误：你当前命名为requirments.txt，正确名称应为requirements.txt（缺少第二个字母e）。虽然直接返回字符串的版本能正常运行，但拼写错误会导致依赖安装不符合预期，部分场景下会触发模板渲染异常。
• 检查部署包是否完整包含templates目录：很多用户打包部署包时仅选中了根目录的py文件和txt文件，遗漏了templates文件夹，导致线上环境找不到模板文件触发报错。你可以解压上传到EB的zip包，确认目录结构是否和本地完全一致。
• 检查文件权限：确保templates目录和index.html文件对应用运行的系统用户开放可读权限，建议目录权限设为755、文件权限设为644。

2 修复模板路径配置 #

Elastic Beanstalk运行应用时的工作目录可能和本地测试场景不一致，相对路径的template_folder配置会找不到模板位置，建议修改为绝对路径配置：

from flask import Flask, render_template
import requests
import os

# 获取当前文件所在的绝对路径作为应用根目录
APP_ROOT = os.path.dirname(os.path.abspath(__file__))
application = Flask(__name__, 
                    template_folder=os.path.join(APP_ROOT, "templates"), 
                    static_folder=os.path.join(APP_ROOT, "static"))

@application.route("/")
def index():
    return render_template('index.html')

if __name__ == "__main__":
    application.debug = True
    application.run()

3 查看日志精确定位问题 #

你可以直接在AWS Elastic Beanstalk控制台的对应环境页，左侧菜单选择「日志」，请求下载最近的完整日志，重点查看以下路径的日志内容：

• /var/log/web.stdout.log：应用输出的标准日志，会打印具体的Python异常栈，比如是否为TemplateNotFound类错误
• /var/log/httpd/error_log：Web服务层的错误日志，可排查权限、请求转发类问题

以上操作可覆盖90%以上的同类报错场景。

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