部署集成GraphCMS的Next.js博客至Vercel时遇版本检测错误求助

第一步：移除干扰性依赖 #

你的package.json里同时存在官方的next包和一个非官方的nextjs（版本0.0.3，属于废弃无效包），Vercel的框架检测逻辑被这个无效包干扰，导致识别不到真正的Next.js环境。

处理方式：

• 执行命令卸载无效包：

  npm uninstall nextjs
  

• 或者直接编辑package.json，删除"nextjs": "^0.0.3"这一行，再运行npm install更新依赖。

第二步：重新配置Vercel部署 #

1. 将部署的框架预设改回Next.js，不要选「other」。
2. 部署前先在本地验证构建是否正常：

   npm run build
   

   如果本地构建失败，先解决本地的报错（比如GraphCMS的API配置、页面路由问题等），再重新发起部署。

第三步：同步环境变量 #

如果你的博客依赖GraphCMS的API密钥、端点等环境变量，务必在Vercel项目的「环境变量」设置里添加对应内容，和本地.env文件保持一致。

第四步：排查404兜底方案（若仍有问题） #

如果部署后还是出现404，检查以下几点：

• 页面文件是否放在pages目录下（Next.js 12基于该目录做路由解析），文件名是否拼写正确。
• 确认next build能正常生成.next目录，Vercel会依赖这个目录的构建产物。
• 查看Vercel部署日志的构建步骤，定位是否有资源缺失、API请求失败等具体报错。

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