Render部署Django应用后无法使用有效超级用户凭据登录Admin后台

最高发原因：Render临时文件系统与SQLite的适配问题 #

• Render的Web服务实例默认使用临时文件系统：运行时写入的文件会在实例重启、重新部署、免费实例休眠唤醒时被完全清空。
• 本地开发时创建的超级用户记录存储在本地db.sqlite3文件中，绝大多数开发者会把*.sqlite3加入.gitignore，不会随代码提交到线上：此时线上环境启动时会自动创建一个全新的空SQLite库，根本不存在本地创建的超级用户账号，输入本地凭据自然无法登录。
• 就算登录Render的Web Shell手动执行python manage.py createsuperuser创建了账号，只要实例触发重启，所有存在SQLite里的数据都会被清空，下次登录依旧会失败。
• 对应修复方案：
  • 临时测试方案（仅用于快速验证功能，不推荐长期使用）：把本地包含超级用户数据的db.sqlite3从.gitignore中移除，提交到代码仓库随项目一起部署。注意这种方式下所有线上产生的用户数据、业务数据都会在实例重启后丢失，且每次本地修改数据库后都要重新提交db文件才能同步到线上。
  • 长期稳定方案：替换SQLite为Render托管PostgreSQL数据库，这也是Render官方推荐的Django部署方式：
    1. 在Render控制台新建托管PostgreSQL实例，获取数据库连接串
    2. 安装依赖：把dj-database-url、psycopg2-binary加入项目的requirements.txt
    3. 修改settings.py中的数据库配置，让线上环境自动读取Render提供的数据库环境变量切换为PostgreSQL，本地开发仍可保留SQLite配置：

       import os
       import dj_database_url
       
       DATABASES = {
           "default": {
               "ENGINE": "django.db.backends.sqlite3",
               "NAME": BASE_DIR / "db.sqlite3",
           }
       }
       # 识别线上环境自动切换数据库
       if "DATABASE_URL" in os.environ:
           DATABASES["default"] = dj_database_url.config(
               conn_max_age=600,
               conn_health_checks=True,
           )
       

    4. 修改Render上的服务构建命令，加上迁移和静态文件收集步骤：pip install -r requirements.txt && python manage.py migrate && python manage.py collectstatic --noinput
    5. 首次部署完成后，在Render的Web Shell中执行python manage.py createsuperuser创建线上专属超级用户，数据会持久化在托管PostgreSQL中，不会随实例重启丢失，即可正常登录Admin。

次常见原因：安全配置错误导致登录请求被拦截 #

如果换完数据库还是无法登录，检查settings.py中的线上安全配置，配置错误会导致登录表单提交被CSRF校验拦截，表现和账号密码错误完全一致：

• 正确配置允许的域名，把Render分配的服务域名加入ALLOWED_HOSTS：

  RENDER_EXTERNAL_HOSTNAME = os.environ.get("RENDER_EXTERNAL_HOSTNAME")
  if RENDER_EXTERNAL_HOSTNAME:
      ALLOWED_HOSTS.append(RENDER_EXTERNAL_HOSTNAME)
  

• 配置CSRF可信源，避免HTTPS环境下的跨域请求拦截：

  if RENDER_EXTERNAL_HOSTNAME:
      CSRF_TRUSTED_ORIGINS = [f"https://{RENDER_EXTERNAL_HOSTNAME}"]
  

• 线上环境（DEBUG=False）下确保开启安全Cookie配置，适配HTTPS协议：

  SESSION_COOKIE_SECURE = True
  CSRF_COOKIE_SECURE = True
  

其他排查点 #

• 检查部署日志，确认构建流程中成功执行了python manage.py migrate，没有报错。如果漏了迁移步骤，线上数据库没有Django内置的auth相关表，自然无法完成账号校验。
• 检查启动命令的工作目录是否正确，避免线上服务启动时读取到错误路径下的空数据库文件。

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