PostgreSQL使用golang-migrate迁移时user表外键关联语法错误如何解决？

问题原因 #

1. 核心语法错误触发原因：user是PostgreSQL的内置保留关键字。你创建user表时使用双引号包裹表名，将其强制识别为自定义标识符，但在activity表的外键定义REFERENCES user(id)中，没有给user加双引号，PostgreSQL会把此处的user解析为保留关键字而非你定义的表名，因此抛出语法错误。你移除user_id列后，对应的错误外键引用也被删除，因此迁移可以正常执行。
2. 脏版本报错原因：迁移执行失败后，golang-migrate会在schema_migrations表中将当前版本标记为脏状态，后续执行迁移前会先校验该状态，不修复的话无法继续执行迁移。

修复方案 #

第一步：处理脏版本状态 #

• 若为开发环境无需保留现有数据，可直接删除当前数据库后重新执行迁移即可。
• 若需要保留现有数据，执行migrate force 1命令强制将版本1标记为干净状态，再执行后续操作。

第二步：修复迁移SQL，两种可选方案 #

方案1：对齐标识符引用写法

给activity表外键引用处的user也加上双引号，和创建表时的写法保持一致，修改对应行代码为：

"user_id" UUID NOT NULL REFERENCES "user"(id),

方案2（更推荐）：避免使用保留关键字作为表名

将user表重命名为users等非保留关键字名称，创建表和外键引用的位置同步修改即可。该方案可以彻底避免后续其他场景下的标识符解析错误，无需每次引用都额外添加双引号。

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