Heroku部署Django项目触发ProgrammingError：accounts_customuser表不存在

问题根源 #

本地用SQLite测试时已完成迁移，表正常存在，但部署到Heroku后，PostgreSQL数据库未执行针对CustomUser模型的迁移操作，导致对应的数据表未创建，因此注册用户时触发500内部错误。

解决步骤 #

1. 确认本地迁移文件完整

   • 检查accounts/migrations/目录下是否存在包含CustomUser模型的迁移文件（比如0001_initial.py）。若没有，先在本地执行：

     python manage.py makemigrations accounts
     

   • 将新生成的迁移文件提交到Git仓库，确保部署到Heroku时能同步这些文件。

2. 在Heroku上执行数据库迁移

   • 登录Heroku CLI后，运行命令完成迁移：

     heroku run python manage.py migrate
     

   • 若之前执行过migrate但未生效，可先重置数据库（注意：此操作会清空现有数据，需谨慎），再重新迁移：

     heroku pg:reset DATABASE
     heroku run python manage.py migrate
     

3. 核对Heroku环境变量配置

   • 确认Heroku已正确设置AUTH_USER_MODEL，执行命令查看：

     heroku config:get AUTH_USER_MODEL
     

   • 若返回结果为空或不是accounts.CustomUser，添加该环境变量：

     heroku config:set AUTH_USER_MODEL=accounts.CustomUser
     

4. 验证数据表是否生成

   • 进入Heroku的PostgreSQL控制台检查：

     heroku pg:psql
     

   • 在控制台中执行查询：

     \dt accounts_customuser
     

   • 若能看到该数据表，说明迁移成功；若未显示，重新执行迁移步骤。

额外提醒 #

• 自定义用户模型建议在项目初始化阶段就配置完成，中途修改用户模型容易引发迁移历史混乱。
• 本地开发时尽量使用PostgreSQL测试，避免SQLite与PostgreSQL的细微差异导致部署后出现问题。

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