Next.js 14中/api/user/create路由被标记为动态的原因排查

我有一个路径为src\app\api\user\create\route.ts的路由文件，代码如下：

import prisma from "@/lib/prisma";

export async function POST() {
  const post = await prisma.user.create({
    data: {
      email: "createuser2@example.com",
      name: "createuser2",
      posts: {
        create: [
          {
            title: "This is user 2",
            published: false,
            categories: {
              connectOrCreate: {
                where: {
                  id: 3,
                },
                create: {
                  name: "Machine Learning",
                },
              },
            },
          },
        ],
      },
    },
  });
  return new Response(JSON.stringify(post));
}

执行npm run build后，该路由被标记为动态：

├ λ /api/user/create                     0 B                0 B

我不清楚代码中哪些内容导致该路由成为动态路由，希望能得到帮助。

原因分析 #

你的API路由被标记为动态（λ标识），核心原因是它包含无法在构建阶段完成的动态操作，Next.js无法将其预生成为静态文件，只能在请求时实时执行。

具体到你的代码，直接诱因是Prisma数据库写入操作：

• prisma.user.create()是运行时的数据库交互，这类操作依赖实时的数据库连接与环境，构建阶段无法提前执行并生成静态结果。
• Next.js会自动识别这类包含数据库调用、外部API请求、请求上下文依赖（如headers()/cookies()）的路由，将其归类为动态路由。

另外补充：你的路由路径是固定的/api/user/create，没有动态参数（如[id]），所以动态标记和路由路径无关，完全是路由内部的代码逻辑导致的。

补充说明 #

你当前的接口是POST类型的创建接口，即使后续改成从请求体获取用户数据而非写死，这类接口也必然是动态的——因为它需要处理实时的请求数据并执行写入操作，静态化对这类接口没有实际意义。如果只是测试场景下想让它静态化，你可以暂时去掉数据库操作，直接返回固定JSON响应，此时Next.js会将其优化为静态路由，但这不符合接口的实际用途。

内容的提问来源于stack exchange，提问作者utkarsh-k