Next.js 13+Sanity+Netlify生产环境博客页500内部服务器错误排查

• 环境变量配置缺失或错误：本地开发依赖.env.local里的Sanity相关变量（如项目ID、API令牌），但Netlify部署时未配置这些变量，或者变量名拼写、前缀（如NEXT_PUBLIC_）与本地不一致，导致请求Sanity接口失败触发500错误。需检查Netlify后台的环境变量设置，确保与本地完全匹配。

• Node.js版本不兼容：本地使用node:20.9.0，但Netlify默认Node版本可能偏低或与本地差异较大，引发依赖安装或运行时兼容性问题。可在项目根目录创建.nvmrc文件写入20.9.0，或在Netlify部署设置中手动指定Node版本为20.9.0。

• Sanity CORS与权限配置问题：Sanity后台的CORS允许列表仅添加了本地地址（如http://localhost:3000），未包含Netlify部署后的站点域名，导致跨域请求失败；同时需确认请求Sanity所用的API令牌具备内容读取权限。

• Next.js渲染逻辑的环境差异：若博客页面使用getStaticProps或getServerSideProps，Netlify构建时可能因网络延迟、Sanity接口响应慢导致构建超时或内容获取失败；使用静态生成时未配置增量静态再生（ISR），也可能因内容动态变化引发页面错误；服务器端渲染时，Netlify函数环境与本地Node环境的差异（如依赖缺失）也会触发500错误。

• 依赖安装不一致：本地用npm安装依赖，但Netlify部署时使用了其他包管理器（如yarn），或未提交package-lock.json到仓库，导致Netlify拉取的依赖版本与本地不符，引发兼容性问题。需确保提交package-lock.json，并在Netlify部署设置中指定包管理器为npm。

• 路径与资源引用错误：本地开发时路径解析正常，但部署后存在绝对路径/相对路径引用错误（如Sanity图片路径处理不当、组件导入路径错误）；若混用Next.js 13的App Router与Pages Router写法，也可能在部署环境触发运行时错误。

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