Python Django部署Heroku报错：如何手动添加数据库字段？

推荐方案：使用Django迁移系统（最佳实践） #

Django的迁移系统是管理数据库schema变更的标准方式，可避免手动操作数据库带来的不一致问题：

• 确认本地models.py中已正确添加目标字段，例如：

  class YourModel(models.Model):
      # 已有字段
      name = models.CharField(max_length=50)
      # 新增字段
      new_field = models.CharField(max_length=100, blank=True)
  

• 本地生成迁移文件：

  python manage.py makemigrations
  

• 将迁移文件提交到版本控制并推送到Heroku：

  git add .
  git commit -m "Add new_field to YourModel"
  git push heroku main
  

• 在Heroku服务器上执行迁移：

  heroku run python manage.py migrate
  

• 验证变更：通过Heroku shell确认字段可用：

  heroku run python manage.py shell
  

  在shell中尝试查询模型，确认无"column does not exist"错误。

手动添加字段（仅当迁移流程无法使用时） #

如果必须手动操作Heroku数据库，按以下步骤执行：

• 连接到Heroku的PostgreSQL数据库：

  heroku psql
  

• 执行ALTER TABLE语句添加字段，根据字段类型调整语法：

  -- 示例：添加允许为空的VARCHAR字段
  ALTER TABLE your_appname_yourmodel ADD COLUMN new_field VARCHAR(100);
  
  -- 示例：添加带默认值且非空的字段
  ALTER TABLE your_appname_yourmodel ADD COLUMN new_field VARCHAR(100) NOT NULL DEFAULT 'default_val';
  

  注意：your_appname_yourmodel是Django自动生成的表名（通常为应用名+模型名小写，下划线分隔），可通过heroku run python manage.py inspectdb查看实际表名。
• 执行完成后输入\q退出psql。
• 关键：手动添加字段后，必须确保本地models.py中的字段定义与数据库完全一致，否则后续迁移会出现冲突。

内容的提问来源于stack exchange，提问作者Eduardo Brandão