Next13禁用DynamicParams后generateStaticParams失效（404错误）

问题描述 #

使用generateStaticParams生成指定分类（POLITICS）的博客静态路由，配置了dynamic: 'force-static'和dynamicParams: false以禁用动态参数、仅返回预生成的静态页面。构建日志显示已生成/posts/my-static-post路由，但生产环境访问该路径时返回404，开发环境及保留动态设置时可正常访问。

相关代码：

generateStaticParams 实现 #

export async function generateStaticParams() {
  let blogPosts = await prisma.posts.findMany({
    where: {
        category: "POLITICS",
    },
  });

  const paths = blogPosts.map((text) => ({
      slug: text.slug,
  }));

  return paths
}

页面配置 #

export default MyPage;
export const dynamic = 'force-static'
export const dynamicParams = false;

构建日志片段：

├ ● /posts/[slug]               0 B                0 B
├   └ /posts/my-static-post
├ ○ /about                      0 B                0 B

可能的解决方法 #

• 检查页面路由结构：确保页面文件放在正确路径下，App Router需放在app/posts/[slug]/page.js，Pages Router需放在pages/posts/[slug].js，路径不匹配会导致路由映射失败。
• 验证slug一致性：确认数据库返回的slug值和访问路径完全匹配，注意大小写、特殊字符编码等细节，比如my-static-post和My-Static-Post会被视为不同路径。
• 升级Next.js版本：部分旧版本Next.js在dynamicParams: false与force-static结合时存在bug，升级到最新稳定版后重新构建部署测试。
• 检查构建输出文件：查看构建后的.next/static或out目录（开启output: 'export'时），确认是否生成了对应/posts/my-static-post的静态HTML文件。如果文件不存在，需排查generateStaticParams的执行问题，比如构建环境中Prisma连接是否正常。
• 检查部署平台路由配置：若部署到Vercel、Netlify等平台，确认平台路由规则是否正确处理静态文件，自定义配置文件（如vercel.json）是否存在冲突规则。
• 手动处理404替代配置：临时移除dynamicParams: false，保留dynamic: 'force-static'，在页面组件内通过notFound()手动校验slug合法性：

  import { notFound } from 'next/navigation'; // App Router
  // import { notFound } from 'next/'; // Pages Router
  
  export default async function MyPage({ params }) {
    const post = await prisma.posts.findUnique({
      where: { slug: params.slug, category: "POLITICS" },
    });
  
    if (!post) {
      notFound();
    }
  
    // 渲染页面内容
  }
  

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