Google Flexible Environment下Django（Gunicorn+gevent）静态文件服务问题

我来帮你梳理排查这个问题——毕竟在Google App Engine Flexible Environment里，静态文件的服务逻辑和本地开发不太一样，尤其是用Gunicorn+gevent的时候，Django本身不适合直接处理静态请求，得靠App Engine的前端服务器来托管。结合你的情况，按下面的步骤逐一排查：

1. 检查app.yaml的静态资源配置（最关键） #

Google Flex环境需要在app.yaml里明确声明静态文件的处理规则，让平台的前端服务器直接接管静态请求，而不是让Gunicorn/Django来处理。你需要添加类似的配置：

runtime: python
env: flex
entrypoint: gunicorn -k gevent -b :$PORT your_project.wsgi

# 静态文件处理规则，要放在所有动态路由之前
handlers:
- url: /static
  static_dir: static
  secure: always
  redirect_http_response_code: 301

# 动态请求交给Django处理
- url: /.*
  script: auto

注意：静态文件的handlers必须放在最前面，否则会被Django的路由规则拦截，导致静态请求还是走到Gunicorn里。

2. 修正STATIC_ROOT为绝对路径 #

你当前用的是相对路径static，在部署环境里可能会出现路径匹配问题。建议在settings.py里改成绝对路径：

import os
BASE_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))

STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(BASE_DIR, 'static')

这样collectstatic会把所有静态文件统一复制到项目根目录下的static文件夹，和app.yaml里的static_dir完全对应。

3. 确保collectstatic在部署时自动执行 #

本地执行collectstatic没用，得让部署过程自动跑这个命令。如果用默认的Flex部署流程，可以在app.yaml里添加runtime_config（如果没加的话），平台会自动帮你执行：

runtime_config:
  python_version: 3.10 # 替换成你实际用的Python版本

如果是自定义Dockerfile部署，记得在Dockerfile里加上：

RUN python manage.py collectstatic --noinput

部署后可以查看Cloud Build的日志，确认collectstatic有没有执行，以及静态文件是否被正确复制到了STATIC_ROOT目录。

4. 检查DRF Swagger的静态文件收集情况 #

有些Swagger库（比如drf-yasg或drf-spectacular）需要确保对应的App在INSTALLED_APPS里，这样collectstatic才会收集它的静态资源：

INSTALLED_APPS = [
    # 其他App...
    'drf_yasg', # 或者 'drf_spectacular'，看你用的库
]

部署完成后，可以登录到App Engine的实例里，检查static文件夹下有没有swagger-ui或对应库的静态文件目录。

5. 测试静态文件的可访问性 #

部署后直接访问一个明确的静态文件URL，比如https://your-project-id.appspot.com/static/admin/css/base.css，如果能正常加载，说明静态服务配置没问题；如果不行，再回头检查app.yaml的handlers顺序和STATIC_ROOT路径是否匹配。

6. 排除gevent的干扰 #

gevent本身不会影响静态文件服务，但如果静态请求意外走到Gunicorn里，可能会出现异常。只要确保app.yaml的静态handlers优先级最高，就不会让Gunicorn处理静态请求，这一步就没问题。

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