常见错误

统一格式：现象 → 原因 → 解决。专题页见同目录其他文档。

登录后跳回首页或一直要求登录

现象: OAuth 看似成功，dashboard 立刻被踢回。

原因:

• Mixin 判定无权限，统一 redirect 到 login
• session cookie 因 HTTPS/代理头不正确而未设为 Secure 或不被保存

解决: 查 Membership；生产确认 Nginx X-Forwarded-Proto 与 SECURE_PROXY_SSL_HEADER。见 Authentication and Configuration。

静态文件 404

现象: 生产页面无样式。

原因: 未 collectstatic；或 DEBUG=True 的 storage 配置被拿到生产。

解决: DEBUG=False 下执行 collectstatic --noinput 并重启 gunicorn。

上传文件能存不能下

现象: 本地 DEBUG 正常，生产下载 404。

原因: 未配 R2 且 Nginx 未暴露 MEDIA_ROOT。

解决: 配齐 R2 四变量，或给 /media/ 做 alias。见 Storage and Uploads。

邮件一直不来

现象: 业务成功，收件箱空。

原因: MAILING_ENABLED=false；SMTP 密钥错；用户关了分类或退订；线程在 worker 重启时被杀。

解决: 见 Email and Integrations。本地用 console backend 确认 registry 有被调用。