Heroku CLI部署Django后端后无法访问Admin且迁移命令报错

问题详情 #

• 通过Heroku CLI部署Web项目后端后，访问<应用名>.herokuapp.com/admin数据库管理页面时出现Internal Server Error
• 尝试进入容器执行数据库迁移，执行heroku run bash进入终端后，输入run migrations触发报错（提示bash: run: command not found）
• Next.js前端部署在Vercel可正常运行，仅Heroku上的Postgres数据库操作（添加数据、迁移）出现异常

解决步骤 #

1. 纠正数据库迁移命令 #

你输入的run migrations不是合法的Shell命令，需根据后端框架执行对应迁移指令：

• Django项目：python manage.py migrate
• Express+Sequelize项目：npx sequelize-cli db:migrate
• Flask+SQLAlchemy-Migrate项目：flask db upgrade

2. 排查后台管理页500错误 #

• 检查数据库迁移状态：完成迁移后重新访问管理页，未迁移的表结构会导致查询失败触发500错误
• 验证环境变量：在Heroku后台查看DATABASE_URL配置，确保后端能正确连接Postgres实例
• 查看错误日志：执行heroku logs --tail获取实时日志，定位500错误的具体堆栈信息（如权限不足、表不存在、依赖缺失）
• 测试数据库连接：在heroku run bash终端中执行psql $DATABASE_URL，直接连接Postgres验证是否能正常执行SQL语句

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