LoopBack4中如何添加外键？数据库迁移时外键未生成求助

我懂你现在卡在哪了——从LoopBack v3升级到v4后，明明用@hasMany定义了模型关联，跑npm run migrate却没在MySQL里生成外键约束。其实这是LoopBack4的默认逻辑：@hasMany这类关联注解主要是帮你搭建业务层的关系映射，不会自动在数据库层面创建外键约束，得额外做几步配置才能实现。

下面是具体的解决步骤：

1. 在子模型（Todo）中补充@belongsTo注解 #

外键是挂在子表（Todo）上的，所以你得在Todo模型里用@belongsTo显式关联TodoList，让LoopBack识别这个字段是外键：

// src/models/todo.model.ts
import { Entity, belongsTo, property } from '@loopback/repository';
import { TodoList } from './todo-list.model';

export class Todo extends Entity {
  @property({
    type: 'number',
    id: true,
    generated: true,
  })
  id?: number;

  // 新增这部分关联配置
  @belongsTo(() => TodoList)
  todoListId: number;

  // 你的其他现有字段...
}

这里要提个细节：你提供的TodoList代码里，todoListId写的是string类型，这大概率是笔误——它得和TodoList的主键（id）类型完全一致（一般是number），不然外键创建会直接失败。

2. 调整数据源的迁移策略 #

默认的迁移模式不会主动创建外键，你需要在数据源配置里把migrate选项改成alter（开发环境推荐，会修改现有表结构）或者drop（会删表重建，仅测试用）：

// src/datasources/todo.datasource.ts
import { juggler } from '@loopback/repository';
import { inject } from '@loopback/core';

export class TodoDataSource extends juggler.DataSource {
  static dataSourceName = 'todo';

  constructor(
    @inject('datasources.config.todo', { optional: true })
    dsConfig: object = {},
  ) {
    super({
      ...dsConfig,
      connector: 'mysql',
      host: 'localhost',
      port: 3306,
      user: '你的数据库用户名',
      password: '你的数据库密码',
      database: '你的数据库名',
      migrate: 'alter', // 关键配置：允许修改表结构添加外键
    });
  }
}

3. （可选）用自定义迁移脚本手动创建外键 #

如果上面两步还是没生效，你可以写个自定义迁移脚本直接执行SQL：

在src/migrations目录下新建一个文件（比如20240520-add-todo-foreign-key.ts）：

import { MigrationScript } from '@loopback/repository';

export const up: MigrationScript = async (dataSource) => {
  const connector = dataSource.connector;
  if (!connector?.execute) return;

  await connector.execute(`
    ALTER TABLE Todo
    ADD CONSTRAINT fk_todo_todolist
    FOREIGN KEY (todoListId) REFERENCES TodoList(id)
    ON DELETE CASCADE ON UPDATE CASCADE;
  `);
};

export const down: MigrationScript = async (dataSource) => {
  const connector = dataSource.connector;
  if (!connector?.execute) return;

  await connector.execute(`
    ALTER TABLE Todo
    DROP CONSTRAINT fk_todo_todolist;
  `);
};

再跑一次npm run migrate，LoopBack就会自动执行这个脚本创建外键了。

额外注意点 #

• 确保你的MySQL用户有ALTER TABLE权限，不然迁移会报错
• 执行迁移前最好备份数据库，尤其是用migrate: 'drop'模式时
• 严格匹配外键字段和关联主键的类型，差一点都不行

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