PM2 serve部署CRA构建的SPA项目日志报大量ENOENT错误如何解决？

问题根因 #

该报错是PM2内置serve脚本的固有逻辑导致：开启SPA模式后，服务会先尝试读取URL路径对应的静态文件，读取失败抛出ENOENT错误后，才会执行回退逻辑返回index.html。虽然功能不受影响，但每次路由访问/页面刷新都会打印这条错误日志，导致日志被冗余信息占满。

解决方案1：修正配置（优先尝试，成本最低） #

你的ecosystem.config.js本身存在格式错误，部分配置参数不符合规范，修正后可以解决大部分场景的报错：

1. 调整配置外层结构，PM2生态配置的标准格式要求所有服务配置必须包裹在apps数组中，否则部分环境变量可能不生效
2. PM2_SERVE_HOMEPAGE不要使用相对路径./index.html，改为根路径/index.html即可
3. 生产环境建议关闭watch: true，避免静态文件变更触发不必要的服务重启

修正后的配置参考：

module.exports = {
  apps: [{
    name: "projectName",
    script: "serve",
    watch: false,
    env: {
      NODE_ENV: "production",
      PM2_SERVE_PATH: './build',
      PM2_SERVE_PORT: 5001,
      PM2_SERVE_SPA: 'true',
      PM2_SERVE_HOMEPAGE: '/index.html'
    }
  }]
}

配置修改完成后执行pm2 reload ecosystem.config.js重启服务即可。

解决方案2：自定义静态服务（永久解决无冗余日志） #

如果修正配置后仍然有报错，可以替换PM2内置的serve脚本，使用express实现极简SPA静态服务，完全自主控制路由逻辑，不会生成多余错误日志：

1. 安装express依赖：
   npm install express --save
2. 项目根目录新建spa-serve.js文件，内容如下：

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

const PORT = process.env.PORT || 5001
const BUILD_PATH = path.join(__dirname, 'build')

// 处理静态资源请求
app.use(express.static(BUILD_PATH))

// 所有非静态资源请求统一返回index.html，适配SPA前端路由
app.get('*', (req, res) => {
  res.sendFile(path.join(BUILD_PATH, 'index.html'))
})

app.listen(PORT, () => {
  console.log(`SPA服务启动成功，端口：${PORT}`)
})

3. 更新ecosystem.config.js配置，指向自定义服务文件：

module.exports = {
  apps: [{
    name: "projectName",
    script: "spa-serve.js",
    watch: false,
    env: {
      NODE_ENV: "production",
      PORT: 5001
    }
  }]
}

4. 重启PM2服务生效：
   pm2 reload ecosystem.config.js

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