GCP App Engine标准环境部署Django返回500错误无法响应请求

已知问题现象 #

• 本地环境Django应用运行正常，可正常连接GCP Cloud SQL数据库
• 部署到Google App Engine标准环境后所有请求均返回500错误，包括仅返回固定字符串的极简测试视图
• 日志存在大量favicon.ico相关500请求，移除页面favicon引用后问题无改善，根路径GET / HTTP/1.1 500错误持续存在

现有核心配置节选 #

views.py（测试接口） #

def index(request):
    return HttpResponse("Congratulations!")

app.yaml #

runtime: python39

env_variables:
  BUCKET_NAME: "mystoragebucket"
  APPENGINE_URL: https://my-project-123456789101.uk.r.appspot.com/

handlers:
- url: /static
  static_dir: static/

- url: /.*
  script: auto

settings.py（节选） #

DEBUG=False
APPENGINE_URL = os.getenv('APPENGINE_URL')
ALLOWED_HOSTS = [APPENGINE_URL[8:]]
CSRF_TRUSTED_ORIGINS = [APPENGINE_URL]
SECURE_SSL_REDIRECT = True
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True
    
STATIC_URL = "https://storage.googleapis.com/mypublicstaticbucket/static/"
SECRET_KEY = 'django-insecure-randomstringhere'

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'HOST': '/cloud_sql/my-project-123456789101:us-east4:MYSQLInstanceNameHere',
        'PORT' : 5432,
        'NAME': 'MyDBNameHere',
        'USER': 'myUsername',
        'PASSWORD': 'MyPassword',
    }
}

排查优先级（按出错概率从高到低） #

1. 优先修复ALLOWED_HOSTS配置错误（90%概率为根因） #

当前配置中APPENGINE_URL值尾部带斜杠，为https://my-project-123456789101.uk.r.appspot.com/，通过[8:]切片后得到的主机名是my-project-123456789101.uk.r.appspot.com/，末尾多了冗余斜杠。
Django的ALLOWED_HOSTS会严格匹配请求头中的Host值，携带斜杠的配置完全无法匹配正常请求，直接触发DisallowedHost异常。由于DEBUG=False，该异常不会返回详细错误页，直接呈现为500错误，连视图逻辑都不会执行，和「极简测试接口也报错」的现象完全吻合。
修复方案二选一即可：

• 去掉app.yaml中APPENGINE_URL的尾部斜杠，改为https://my-project-123456789101.uk.r.appspot.com，现有切片逻辑可正常工作
• 直接写死ALLOWED_HOSTS配置，避免切片逻辑出错：ALLOWED_HOSTS = ['my-project-123456789101.uk.r.appspot.com', '.appspot.com']

2. 补全Cloud SQL连接配置 #

GAE标准环境连接Cloud SQL不能仅配置Unix Socket路径，必须满足两个配置要求，否则会因数据库连接失败触发500：

• 在app.yaml中添加beta_settings块声明要连接的Cloud SQL实例，缺失该配置时GAE不会自动挂载/cloud_sql/目录下的Unix Socket文件：

beta_settings:
  cloud_sql_instances: "my-project-123456789101:us-east4:MYSQLInstanceNameHere"

• 核对数据库配置匹配性：当前配置中数据库引擎写的是PostgreSQL，但实例名标注为MySQL实例，需根据实际数据库类型修正：如果是PostgreSQL实例需填写正确的PostgreSQL实例名，依赖中添加psycopg2-binary；如果是MySQL实例需将引擎改为django.db.backends.mysql、端口改为3306，依赖中添加mysqlclient。同时确认GAE服务使用的服务账号已授予Cloud SQL Client权限。

3. 检查依赖配置 #

确认项目根目录存在requirements.txt文件，且列出了所有运行所需依赖（Django、对应数据库驱动等）。GAE部署时不会复用本地环境的依赖包，缺失依赖会导致应用启动失败直接返回500。

4. favicon.ico报错说明 #

该现象为连带问题，不是根因：浏览器会默认自动请求站点根路径下的favicon.ico，未配置对应路由时本应返回404，但由于前面的全局错误，所有请求无论路径是什么都会触发500，因此日志中会出现该路径的报错。根因修复后，该请求会正常返回404，配置favicon路由后即可消除对应日志。 #

快速验证流程 #

1. 先修复ALLOWED_HOSTS的斜杠问题，重新部署后测试根路径是否能正常返回Congratulations!
2. 若仍返回500，直接前往GAE日志查看器读取完整错误栈，优先排查DisallowedHost、数据库连接失败、模块缺失三类报错
3. 补全app.yaml中的Cloud SQL实例声明配置，核对数据库引擎、实例名、账号密码的正确性
4. 确认requirements.txt包含所有依赖，且部署过程中无依赖安装失败的日志

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