Next.js 14构建报TypeError: Invalid URL，疑与sequelize-typescript相关

问题详情 #

• 使用 Next.js 14 App Router 开发纯API服务
• npm run dev 和 npm run test 运行完全正常，但执行 npm run build 时始终抛出 TypeError: Invalid URL 错误，错误输入值为 undefined
• 触发条件：代码中涉及数据库操作（如调用 db.sequelize.sync()、Order.update() 等）时必现
• 相关版本：Next.js ^14.2.4，Node v20.11.0，sequelize-typescript ^2.1.6

可能的原因与解决方案 #

1. 构建阶段环境变量未正确加载 #

Next.js 开发阶段会自动加载 .env.local 等本地环境变量，但构建阶段默认不会。如果数据库连接URL依赖环境变量，构建时变量未注入会导致值为 undefined，进而触发URL解析错误。

解决步骤：

• 将数据库连接相关变量（如 DATABASE_URL）添加到 .env.production 文件，确保构建阶段可访问；
• 检查 Sequelize 配置代码，确认环境变量读取逻辑正确，避免构建时被静态替换为 undefined；
• 对于App Router，直接使用 process.env 访问变量即可，但需保证构建前变量已注入（可通过CI/CD变量或构建命令传入）。

2. 数据库初始化时机不当 #

Next.js 构建阶段会对所有路由文件做静态分析，如果在模块顶层直接执行数据库初始化（如 db.sequelize.sync()），构建时会尝试执行该代码，但此时运行环境未准备完全（比如环境变量未加载），导致URL解析失败。

解决步骤：

• 将数据库初始化逻辑移到API路由的处理函数内部，避免模块加载时执行：

export async function GET() {
  // 延迟加载数据库模块并初始化
  const db = await import('@/lib/db');
  await db.sequelize.sync();
  // 后续业务逻辑
}

• 或者在路由文件顶部添加 export const dynamic = 'force-dynamic'，禁用静态分析，强制运行时执行代码；
• 也可使用懒加载方式封装数据库模块，确保初始化逻辑仅在运行时执行。

3. sequelize-typescript 与 Next.js 构建流程不兼容 #

sequelize-typescript 的类型转换或初始化逻辑可能与Next.js的SWC编译器冲突，导致构建时无法正确解析数据库配置。

解决步骤：

• 尝试升级或降级 sequelize-typescript 到已知兼容的版本；
• 修改 next.config.js，将 sequelize-typescript 加入转译列表并禁用SWC压缩：

module.exports = {
  swcMinify: false,
  transpilePackages: ['sequelize-typescript'],
};

• 临时替换为纯 Sequelize（移除 sequelize-typescript），验证是否是类型库导致的问题。

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