Next.js Prisma披萨电商站报错：prisma.category.findMany()调用无效

问题概述 #

开发披萨电商全栈项目时，遇到两个阻碍推进的错误：Prisma查询PostgreSQL时提示预编译语句已存在，同时终端出现payload参数类型错误的未处理拒绝。

错误详情 #

1. 浏览器端查询错误

触发位置：app/(root)/page.tsx第16行async Home函数

[ Server ] Error: 
Invalid `prisma.category.findMany()` invocation:

Error occurred during query execution:
ConnectorError(ConnectorError { user_facing_error: None, kind: QueryError(PostgresError { code: "42P05", message: "prepared statement \"s0\" already exists", severity: "ERROR", detail: None, column: None, hint: None }), transient: false })

2. 终端未处理拒绝错误

▲ Next.js 15.1.0
   - Local:        http://localhost:3000
   - Network:      http://192.168.0.103:3000
   - Environments: .env

 ✓ Starting..
 ✓ Ready in 3.7s
 ○ Compiling / ..
 ✓ Compiled / in 7.8s (1328 modules)
[TypeError: The "payload" argument must be of type object. Received null] {
  code: 'ERR_INVALID_ARG_TYPE'
}
 ⨯ unhandledRejection: [TypeError: The "payload" argument must be of type object. Received null] {
  code: 'ERR_INVALID_ARG_TYPE'
}
 ⨯ unhandledRejection:  [TypeError: The "payload" argument must be of type object. Received null] {
  code: 'ERR_INVALID_ARG_TYPE'
}

解决方案尝试 #

针对PostgreSQL预编译语句错误（42P05） #

1. 规范Prisma Client实例化
   确保prisma/prisma-client.ts中只创建单例实例，避免重复初始化导致连接池混乱：

   import { PrismaClient } from '@prisma/client'
   
   const prisma = global.prisma || new PrismaClient()
   
   if (process.env.NODE_ENV !== 'production') global.prisma = prisma
   
   export default prisma
   

   禁止在组件或请求处理函数内重复执行new PrismaClient()。

2. 重置数据库连接

   • 重启PostgreSQL服务，清除残留的预编译语句；
   • 检查.env中的数据库连接字符串，添加合理的连接池参数：

     DATABASE_URL="postgresql://user:password@localhost:5432/dbname?connection_limit=10"
     

3. 升级Prisma版本
   该错误可能源于版本兼容问题，执行以下命令升级并重新生成Client：

   npm update @prisma/client prisma
   npx prisma generate
   

针对payload参数类型错误 #

1. 捕获异步逻辑的null返回
   检查page.tsx第16行附近的异步代码，添加try/catch处理null场景，避免将null传入需要对象的API：

   async function Home() {
     try {
       const categories = await prisma.category.findMany()
       // 显式处理categories为null的情况
       if (!categories) return <div>暂无分类数据</div>
       return <div>{/* 渲染分类内容 */}</div>
     } catch (error) {
       console.error('获取分类失败:', error)
       return <div>加载失败</div>
     }
   }
   

2. 检查Next.js数据获取逻辑
   Next.js 15中页面组件的异步数据返回需确保合法，避免传递null给状态管理或响应处理函数。

额外建议 #

• 运行npx prisma validate验证prisma/schema.prisma的模型定义是否存在语法错误；
• 排查项目中所有异步Promise，确保均添加catch处理，避免未处理拒绝报错。

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