1. 自动切换 Node 版本失败 (Switching Error)#

现象：构建日志显示 Switching node version 后面跟着一串红色的 Switching error。 对策：

• 在根目录创建 .nvmrc 文件，明确指定 20。
• 在 package.json 的 engines 字段中锁定 Node 版本。

2. 消失的适配器：@edgeone/next#

现象：npm install 时报 404，找不到官方文档提到的适配器包。 对策：不要试图在本地安装它。腾讯云的 eo-next 指令实际上是内置在构建环境里的。在 package.json 的脚本中直接写 next build && eo-next build 即可。

3. 终极奥义：静态导出 (Static Export)#

如果你追求极致的加载速度和稳定性（避免 /posts?_rsc=... 这种动态路由报 404），静态导出是唯一的正确答案。

1
const nextConfig = {
2
  output: 'export',
3
  images: {
4
    unoptimized: true, // 静态导出必须禁用图片优化
5
  },
6
};