Django生产环境Debug=False时admin面板增删功能异常

问题现象 #

生产环境部署Django项目时，配置DEBUG = False后Admin后台无法新增、删除数据条目；切回DEBUG = True时所有后台功能运行完全正常。

• DEBUG=True时后台正常运行状态：
  
• DEBUG=False时后台功能失效状态：
  

问题根因 #

这是Django切换生产模式后的典型配置类问题，90%以上的同类问题由以下两个原因导致：

• 静态资源托管失效：Django Admin的新增、删除等交互逻辑完全依赖框架自带的JS/CSS资源，DEBUG=True时框架会自动启动静态文件服务托管这些资源，一旦关闭Debug模式，内置静态服务会自动停止。如果此时没有手动完成静态文件收集、配置Web服务器托管静态目录，Admin的JS/CSS会全部加载失败，交互按钮直接失效，看起来就是点了没反应、功能不可用。
• 安全校验拦截：DEBUG=False时Django会强制开启全量安全校验，ALLOWED_HOSTS、CSRF、Cookie安全相关配置缺失的话，新增、删除这类POST请求会直接被403拦截，无法正常提交。

修复步骤 #

1. 修正settings.py核心配置 #

确保生产环境配置文件中以下参数配置正确：

# 关闭Debug模式
DEBUG = False
# 填入服务对应的域名、服务器公网IP，生产环境禁止留空或使用通配符*
ALLOWED_HOSTS = ["你的业务域名", "服务器公网IP"]

# 静态资源相关配置
STATIC_URL = "/static/"
# 执行collectstatic命令后，所有静态文件会被收集到该目录，需配置为项目下的绝对路径
STATIC_ROOT = os.path.join(BASE_DIR, "staticfiles")
# 自定义静态文件存放目录，无自定义需求可留空
STATICFILES_DIRS = [
    os.path.join(BASE_DIR, "static"),
]

# 上传文件（对应模型中FileField/ImageField字段）相关配置
MEDIA_URL = "/media/"
MEDIA_ROOT = os.path.join(BASE_DIR, "media")

如果站点启用HTTPS，额外追加以下配置：

CSRF_TRUSTED_ORIGINS = ["https://你的业务域名"]
SESSION_COOKIE_SECURE = True
CSRF_COOKIE_SECURE = True

2. 执行静态资源收集与数据库迁移 #

配置完成后，在项目根目录依次执行以下命令：

# 收集所有app（含Django Admin）的静态文件到STATIC_ROOT目录
python manage.py collectstatic --noinput
# 确认所有数据库迁移执行完成，避免模型变更未同步导致的异常
python manage.py migrate

3. 配置Web服务器托管静态资源 #

生产环境不要让Django处理静态、媒体资源请求，通过Nginx/Apache等Web服务器直接托管对应目录，Nginx配置参考：

# 托管静态资源
location /static/ {
    alias /项目绝对路径/staticfiles/;
    expires 30d;
}
# 托管用户上传的媒体资源
location /media/ {
    alias /项目绝对路径/media/;
    expires 30d;
}
# 动态请求转发给Django服务（Gunicorn/uWSGI等）
location / {
    proxy_pass http://127.0.0.1:你Django服务的端口;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    # 传递CSRF请求头，避免POST请求被拦截
    proxy_set_header X-CSRFToken $http_x_csrftoken;
}

4. 验证修复 #

重启Django服务与Web服务器后，打开浏览器开发者工具的Network面板，访问Admin后台：

• 如果控制台存在JS/CSS资源404报错，回到静态资源配置环节排查路径、权限问题
• 如果点击新增/删除时返回403错误，排查ALLOWED_HOSTS、CSRF相关配置
• 如果返回500错误，查看Django日志定位具体异常

附：提问者提供的项目代码 #

models.py #

class Portfolio(models.Model):
    miniaturka=models.FileField(blank=False)
    logo=models.FileField(blank=True)
    nazwa=models.CharField(max_length=300, blank=False)
    link=models.CharField(max_length=400, blank=True)
    grafika=models.FileField(blank=True)
    grafika_mobilna=models.FileField(blank=True) 
    opis=models.TextField(blank=True)

    class Meta:
        verbose_name="Portfolio"
        verbose_name_plural="Portfolio"

    def __str__(self):
        return self.nazwa

class PortfolioRow(models.Model):
    portfolio = models.ForeignKey(Portfolio, default=None, on_delete=models.CASCADE)
    portfolioRowType = models.ForeignKey(PortfolioRowType, null=True, blank=True, 
on_delete=models.CASCADE)
    photo1 = models.FileField(blank=True)
    photo2 = models.FileField(blank=True)

    def __str__(self):
        return self.portfolio.nazwa

class PortfolioVideo(models.Model):
    portfolio = models.ForeignKey(Portfolio, default=None, on_delete=models.CASCADE)
    link = models.CharField(max_length=300)

    def __str__(self):
        return self.portfolio.nazwa

admin.py #

from typing import List
from django.contrib import admin
from main.models import *

class PortfolioRowAdmin(admin.StackedInline):
    model = PortfolioRow

class PortfolioVideoAdmin(admin.StackedInline):
    model = PortfolioVideo

@admin.register(Portfolio)
class PortfolioAdmin(admin.ModelAdmin):
    inlines = [PortfolioRowAdmin, PortfolioVideoAdmin]

    class Meta:
        model = Portfolio

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