Node.js Express+TypeScript中SWC转译器引发的ReferenceError问题

以下是几种针对性的解决方案，按推荐优先级排序：

1. 抽离关联逻辑到单独文件（最优解） #

将模型的关联定义从模型文件中分离，确保所有模型加载完成后再执行关联：

• 步骤1：修改模型文件：移除User和Role模型内的关联代码，只保留模型结构与初始化逻辑。
• 步骤2：创建关联初始化文件（比如src/models/associations.ts）：

import User from './User';
import Role from './Role';

// 定义多对多关联
User.belongsToMany(Role, { through: 'UserRole' });
Role.belongsToMany(User, { through: 'UserRole' });

• 步骤3：在项目入口加载：先导入所有模型，再导入关联文件：

// app.ts 或入口文件
import './models/User';
import './models/Role';
import './models/associations';

2. 调整SWC配置优化循环引用处理 #

在.swcrc中修改配置，让转译后的代码更友好地处理循环引用：

{
  "jsc": {
    "parser": {
      "syntax": "typescript",
      "tsx": false
    },
    "transform": {
      "legacyDecorator": true,
      "decoratorMetadata": true
    },
    "target": "es2020",
    "keepClassNames": true
  },
  "module": {
    "type": "commonjs",
    "strict": true,
    "strictMode": true,
    "noInterop": false
  }
}

核心是开启module.strict和strictMode，同时使用较新的ES目标版本，减少转译时的变量提升冲突。

3. 延迟关联定义（快速临时修复） #

利用Sequelize的模型缓存，在模型中判断关联对象存在后再执行关联：

User模型示例： #

import { Model, DataTypes } from 'sequelize';
import sequelize from '../db/connection';

class User extends Model {}

User.init(
  {
    // 你的用户属性配置
  },
  { sequelize, modelName: 'User' }
);

// 延迟关联：确保Role模型已初始化
if (sequelize.models.Role) {
  User.belongsToMany(sequelize.models.Role, { through: 'UserRole' });
}

export default User;

Role模型示例： #

import { Model, DataTypes } from 'sequelize';
import sequelize from '../db/connection';

class Role extends Model {}

Role.init(
  {
    // 你的角色属性配置
  },
  { sequelize, modelName: 'Role' }
);

// 延迟关联：确保User模型已初始化
if (sequelize.models.User) {
  Role.belongsToMany(sequelize.models.User, { through: 'UserRole' });
}

export default Role;

4. 统一模块系统配置 #

避免ES模块与CommonJS混用导致的初始化顺序问题：

• 在tsconfig.json中确保模块配置一致：

{
  "compilerOptions": {
    "module": "CommonJS",
    "target": "ES2020",
    "moduleResolution": "Node"
  }
}

• 同步.swcrc的module.type为commonjs，保证转译前后模块系统一致。

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