Next.js/Prisma/Heroku新增数据库用户提示已存在报错排查

• 错误处理逻辑过于粗糙：接口的catch块没有区分Prisma抛出的具体错误类型，把所有用户创建失败的场景（包括参数缺失、非空约束违反、数据库连接异常、唯一键冲突）全部统一返回「User already exists」，完全掩盖了真实报错原因，直接误导排查方向。
• 请求参数未被正确读取：接口没有提前做参数校验，当POST请求的请求体未被正确解析时，req.body里拿不到传入的email和password字段，两个值都是undefined，触发数据库非空约束报错，被catch块误判为邮箱重复。
• 存在脏数据触发唯一键冲突：之前多次失败的请求大概率已经在User表中写入了email为null的异常记录，而User模型中email字段加了@unique唯一约束，后续所有参数解析失败的请求都会尝试再次写入null值，和已存在的null值触发唯一约束冲突，导致一直报重复错误。

• 第一步：清理脏数据
  打开Prisma Studio，查看User表所有记录，把所有email为null、空值的异常记录全部删除，消除隐藏的唯一键冲突。
• 第二步：重构接口逻辑
  替换原有signup接口代码，新增请求方法校验、参数前置校验，同时修改错误判断逻辑，只在真实发生邮箱唯一冲突时返回用户已存在的提示，其他错误打印日志方便排查：

import bcrypt from 'bcrypt'
import jwt from 'jsonwebtoken'
import cookie from 'cookie'
import { NextApiRequest, NextApiResponse } from 'next'
import prisma from '../../lib/prisma'

export default async (req: NextApiRequest, res: NextApiResponse) => {
    // 仅允许POST方法访问
    if (req.method !== 'POST') {
        return res.status(405).json({ error: 'Method not allowed' })
    }

    const { email, password } = req.body
    // 前置校验必填参数
    if (!email || !password) {
        return res.status(400).json({ error: 'Missing email or password' })
    }

    const salt = bcrypt.genSaltSync()
    let user

    try {
        user = await prisma.user.create({
            data: {
                email,
                password: bcrypt.hashSync(password, salt),
            },
        })
    } catch (e: any) {
        // Prisma唯一约束冲突错误码为P2002，仅此时返回用户已存在
        if (e.code === 'P2002' && e.meta?.target?.includes('email')) {
            return res.status(401).json({ error: 'User already exists' })
        }
        // 其他错误打印日志返回服务端错误，方便排查
        console.error('Create user error:', e)
        return res.status(500).json({ error: 'Internal server error' })
    }

    const token = jwt.sign(
        {
            email: user.email,
            id: user.id,
            time: Date.now(),
        },
        'hello',
        { expiresIn: '8h' }
    )

    res.setHeader(
        'Set-Cookie',
        cookie.serialize('TRAX_ACCESS_TOKEN', token, {
            httpOnly: true,
            maxAge: 8 * 60 * 60,
            path: '/',
            sameSite: 'lax',
            secure: process.env.NODE_ENV === 'production',
        })
    )

    res.json(user)
}

• 第三步：确认配置正确性
  检查项目根目录的next.config.js文件，确认没有手动关闭Next.js API路由默认的bodyParser功能，默认配置本身就支持解析JSON格式的请求体，不需要额外引入第三方解析包。
• 第四步：验证效果
  重启本地Next开发服务，重新执行之前的HTTPie请求命令：
  http POST :3000/api/signup email=h@h.com password=abcabc
  即可正常创建用户，返回对应用户信息和cookie。

额外提醒：代码里硬编码的JWT密钥hello仅适合本地开发测试，生产环境一定要替换为存在环境变量里的随机长密钥，避免安全风险。

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