Django+Nginx+Gunicorn环境下如何禁用缓存？页面修改不生效

我来帮你搞定这个问题——既然本地开发环境修改后能立即生效，那问题肯定出在服务器端的缓存机制或者进程重载环节上，咱们一步步排查解决：

1. 强制禁用Django模板缓存 #

虽然你已经把DEBUG设为True，Django默认不会缓存模板，但有时候还是会有模板加载缓存的情况。咱们直接在settings.py里明确配置，让模板每次请求都重新加载：

修改TEMPLATES配置块，注意要把APP_DIRS设为False才能自定义模板加载器：

TEMPLATES = [
    {
        'BACKEND': 'django.template.backends.django.DjangoTemplates',
        'DIRS': [os.path.join(os.path.join(BASE_DIR, 'templates')), ],
        'APP_DIRS': False,  # 必须设为False才能启用自定义loaders
        'OPTIONS': {
            'loaders': [
                'django.template.loaders.filesystem.Loader',
                'django.template.loaders.app_directories.Loader',
            ],
            'context_processors': [
                'django.template.context_processors.debug',
                'django.template.context_processors.request',
                'django.contrib.auth.context_processors.auth',
                'django.contrib.messages.context_processors.messages',
            ],
            'debug': DEBUG,  # 确保模板调试模式开启
        },
    },
]

另外检查下你的MIDDLEWARE列表，确保没有添加django.middleware.cache.UpdateCacheMiddleware和django.middleware.cache.FetchFromCacheMiddleware这类全局缓存中间件——看你的配置里确实没有，这点没问题。

2. 重启Gunicorn进程 #

Gunicorn会把Django应用加载到内存中运行，修改代码后如果不重启Gunicorn，它会一直使用内存里的旧代码。所以每次修改后必须重启Gunicorn：

如果用systemd管理Gunicorn： #

sudo systemctl restart gunicorn.service

如果是直接后台运行的Gunicorn进程： #

先找到主进程ID，然后平滑重启（不中断现有请求）：

ps aux | grep gunicorn
sudo kill -HUP <gunicorn_master_pid>

要是平滑重启没用，就直接杀掉进程再重新启动：

sudo kill <gunicorn_pid>
gunicorn --workers 3 --bind unix:/home/testapp/testapp_project/test_artciles.sock webarticles.wsgi:application &

提示：开发阶段可以给Gunicorn加--reload参数，让它自动检测代码变化重启，但生产环境不建议这么用。

3. 禁用Nginx对静态资源的缓存 #

浏览器可能会缓存Nginx返回的静态文件（CSS/JS/图片等），导致你修改了静态文件却看不到变化。咱们修改nginx.conf里的static和media位置配置，添加禁用缓存的响应头：

location = /favicon.ico { access_log off; log_not_found off; }

location /static/ {
    root /home/testapp/testapp_project/test_artciles;
    expires -1;  # 标记为立即过期
    add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate";
    add_header Pragma "no-cache";
    add_header X-Content-Type-Options nosniff;
}

location /media/ {
    root /home/testapp/testapp_project/test_artciles;
    expires -1;
    add_header Cache-Control "no-store, no-cache, must-revalidate, proxy-revalidate";
    add_header Pragma "no-cache";
    add_header X-Content-Type-Options nosniff;
}

location / {
    include proxy_params;
    proxy_pass http://unix:/home/testapp/testapp_project/test_artciles.sock;
}

修改完Nginx配置后，重启Nginx生效：

sudo systemctl restart nginx

4. 同步静态文件到Nginx读取目录 #

如果你修改了Django app里的静态文件，一定要在服务器上执行collectstatic命令，把静态文件同步到STATIC_ROOT目录（也就是Nginx读取的目录）：

python manage.py collectstatic --noinput

因为你的Nginx是从/home/testapp/testapp_project/test_artciles/static读取静态文件的，不执行这个命令，修改的静态文件不会同步过去。

日常修改后的操作流程 #

为了确保每次修改都能立即生效，建议按以下步骤操作：

• 如果修改了静态文件：先执行python manage.py collectstatic --noinput
• 重启Gunicorn进程
• 如果修改了Nginx配置：重启Nginx

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