Vercel部署独立后端无启动日志问题求助

问题描述 #

我正尝试通过Vercel部署一个全栈网站，原本前后端在同一GitHub仓库，现已拆分至独立仓库。访问后端页面可正常显示Hello World，但控制台未输出“Server started on port (port)”启动日志。本地终端运行该代码时可正常打印日志，此前前后端同仓时前端发起GET请求还出现过无响应的错误。

后端代码如下：

const express = require('express');
const app = express();

const PORT = process.env.PORT || 8040;

app.get('/', (req, res, next) => {
  res.send('Hello World!');
});

app.listen(PORT, () => {
  console.log(`Server started on port ${PORT}`);
});

module.exports = app;

问题原因及解决方法 #

1. 无启动日志的原因与修复 #

Vercel部署Node.js服务默认采用Serverless Function模式，不会像本地那样持续运行HTTP服务器。app.listen()的回调仅在本地启动服务器时触发，Vercel环境下不会执行这段逻辑，因此看不到启动日志。

适配Vercel Serverless模式的代码修改

移除app.listen()的启动逻辑，直接导出Express实例，让Vercel的运行时处理请求：

const express = require('express');
const app = express();

app.get('/', (req, res, next) => {
  res.send('Hello World!');
});

// 移除app.listen，直接导出app实例
module.exports = app;

如果需要本地测试，可单独创建server.js文件用于本地启动：

const app = require('./app');
const PORT = process.env.PORT || 8040;

app.listen(PORT, () => {
  console.log(`Server started on port ${PORT}`);
});

本地运行node server.js即可正常查看启动日志。

2. 前后端同仓时请求无响应的修复 #

前后端同仓部署时，Vercel会优先识别前端框架的配置，导致后端接口无法被正确路由。解决方式：

• 在仓库根目录创建vercel.json配置文件，指定路由规则：

{
  "rewrites": [
    { "source": "/api/(.*)", "destination": "/api/$1" }
  ]
}

• 将后端代码放在api目录下（Vercel默认会把该目录识别为Serverless Functions目录），比如api/index.js，内容使用上述修改后的Express实例导出代码。

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