部署说明

解决 "Failed to find Server Action" 错误

在 PM2 自托管 Next.js 时，若出现以下错误：

Error: Failed to find Server Action. This request might be from an older or newer deployment.

原因：Next.js 为 Server Actions 使用加密密钥，每次构建会重新生成。部署后客户端可能仍缓存旧版本 JS，导致请求的 action ID 与服务器不匹配。

解决方案：在构建时设置固定加密密钥 NEXT_SERVER_ACTIONS_ENCRYPTION_KEY，使多次部署使用相同密钥。

步骤

生成密钥（仅需执行一次，之后复用同一密钥）：
```
node scripts/generate-encryption-key.js
```

在构建前设置环境变量：

export NEXT_SERVER_ACTIONS_ENCRYPTION_KEY="<上一步输出的 base64 字符串>"
pnpm build

或在 .env / .env.production 中添加：

NEXT_SERVER_ACTIONS_ENCRYPTION_KEY=<base64 字符串>

重新构建并重启：
```
pnpm build
pm2 restart vip
```
建议用户清除缓存：部署后若仍有问题，可让用户执行硬刷新（Ctrl+Shift+R）或清除浏览器缓存。

PM2 部署流程

# 1. 安装依赖
pnpm install

# 2. 设置 NEXT_SERVER_ACTIONS_ENCRYPTION_KEY 后构建
export NEXT_SERVER_ACTIONS_ENCRYPTION_KEY="你的密钥"
pnpm build

# 3. 启动
pnpm start
# 或使用 PM2
pm2 start npm --name vip -- start

1.4 KiB Raw Blame History Unescape Escape

部署说明

解决 "Failed to find Server Action" 错误

步骤

PM2 部署流程

1.4 KiB

Raw Blame History