LoopBack 4应用Vercel部署异常求助：路由与Explorer无法工作

以下是针对问题的具体排查和解决步骤：

• 配置Vercel路由转发规则
  Vercel默认仅处理静态资源请求，不会自动转发API路由到Node.js后端。需要在项目根目录创建vercel.json文件，添加重写规则让所有请求都指向LoopBack的入口文件：

  {
    "rewrites": [
      { "source": "/(.*)", "destination": "/index.js" }
    ]
  }
  

  这个配置会把包括API路径、API Explorer（/explorer）在内的所有请求转发到后端服务，确保LoopBack能处理这些请求。

• 检查端口配置
  Vercel会动态分配运行端口，不能在代码里硬固定端口号。打开src/index.ts，确认端口读取逻辑为：

  const port = Number(process.env.PORT) ?? 3000;
  

  确保服务监听的是Vercel提供的环境变量端口。

• 验证API Explorer启用状态
  打开src/application.ts，确认API Explorer组件已启用且路径配置正确：

  this.configure(ApiExplorerBindings.COMPONENT).to({
    path: '/explorer',
    enabled: true,
  });
  

  避免代码中意外禁用了API Explorer功能。

• 检查Vercel构建与启动配置
  在Vercel项目的「Settings」→「Build & Development Settings」中：

  • 构建命令设置为npm run build && npm start（确保TypeScript编译完成后启动服务）
  • 输出目录设置为dist（LoopBack编译后的代码默认输出到该目录）

• 查看部署日志排查错误
  进入Vercel控制台的「Deployments」页面，点击对应部署记录查看日志，确认：

  • 所有依赖是否安装成功
  • LoopBack服务是否正常启动
  • 有没有端口冲突、模块缺失等报错信息

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