Next.js+Strapi项目部署Vercel后非超管新增内容动态页404需重部署如何解决

AI 小北

2026-9-30

问题根因

1. `getStaticPaths` 配置错误

你当前动态页配置的 fallback: false 是触发404的核心原因：这个参数的逻辑是仅允许访问项目构建阶段预生成的路径，所有构建完成后新增的内容对应的路径都会直接返回404，必须重新部署触发全量构建生成新路径才能正常访问。
你设置的 revalidate: 1 仅对已经生成过的页面的内容更新生效，对构建阶段不存在的新路径完全不生效。

2. 角色权限差异的关联原因

超级管理员新建内容正常的常见可能性有两种：

你配置了Strapi webhook，仅超级管理员的内容操作会触发Vercel自动部署钩子，自动完成全量构建生成新路径
作者/编辑角色新建的内容默认是草稿状态，前端API请求默认拉取不到未发布的草稿内容，就算路径生成也会拿不到数据

解决方案

调整getStaticPaths参数，将fallback: false改为fallback: 'blocking'
调整后访问未预生成的新路径时，Next.js会自动在服务端实时调用getStaticProps生成页面，生成完成后缓存到CDN，后续访问和预生成页面表现一致，无需重新部署即可正常访问新内容。
修改后的代码示例：
```
export async function getStaticPaths() {
  const spectacles = await fetchAPI("/spectacles")
  return {
    paths: spectacles.map((spectacle) => ({
      params: {
        slug: spectacle.slug,
      },
    })),
    fallback: 'blocking',
  }
}
```
排查Strapi权限配置
1. 确认作者/编辑角色新建内容时是否默认发布，若默认存为草稿，要么调整角色发布权限，要么调整API规则允许前端拉取草稿内容（生产环境不推荐）
2. 确认前端调用Strapi API所用的Token，是否配置了spectacles内容类型的find、findOne权限，避免低权限角色发布的内容被API权限拦截拉取不到
如果需要主动触发页面更新，可配置Strapi webhook，所有角色发布内容时都调用Vercel的增量再生钩子，无需全量部署即可更新页面缓存。