当前位置：首页 > ops >正文

数据库的SQLSTATE[23000]异常，通过自定义异常类来提供更友好的提示信息

ops 2025/9/2 6:10:46

操作数据库的时候经常会遇到报错：SQLSTATE[23000]: Integrity constraint violation: 1062 Duplicate entry ，报错信息给开发者调试没问题，直接展示给用户的话，用户就以为是程序乱码或者程序有问题，实际上是原始提示太不直观

你可以通过自定义异常类来提供更友好的提示信息。以下是实现方案：

1. 创建自定义数据库异常类

<?php
namespace app\exception;use think\Exception;class DatabaseOperationException extends Exception
{// 常见数据库错误码映射const ERROR_MAP = [1062 => '数据已存在，请勿重复添加',1451 => '操作失败，存在关联数据',1452 => '操作失败，关联数据不存在',// 可以添加更多错误码映射];// 字段重复映射（可根据需要扩展）const FIELD_MAP = ['id_code' => '身份证号','username' => '用户名','email' => '邮箱','phone' => '手机号',];public function __construct($message = "", $code = 0, \Throwable $previous = null){// 如果是已知的数据库错误码，转换为友好提示if (preg_match('/SQLSTATE\[23000\]:.*1062.*Duplicate entry \'.*\' for key \'(\w+)\'/', $message, $matches)) {$field = $matches[1] ?? '';$fieldName = self::FIELD_MAP[$field] ?? $field;$message = "{$fieldName}已存在，请勿重复添加";$code = 1062;}parent::__construct($message, $code, $previous);}/*** 从数据库异常创建自定义异常*/public static function createFromDbException(\Throwable $e){// 尝试从错误信息中提取错误码if (preg_match('/SQLSTATE\[23000\]:.*(\d{4})/', $e->getMessage(), $matches)) {$errorCode = $matches[1] ?? 0;$message = self::ERROR_MAP[$errorCode] ?? $e->getMessage();return new self($message, $errorCode, $e);}return new self($e->getMessage(), $e->getCode(), $e);}
}

2. 使用方式

try {// 尝试创建用户$user = User::create($userData);
} catch (\think\db\exception\DbException $e) {// 转换为自定义异常throw DatabaseOperationException::createFromDbException($e);
} catch (\Exception $e) {// 其他异常处理throw new \Exception('操作失败，请稍后再试');
}

3. 全局异常处理（可选）

// 在app/ExceptionHandle.php中public function render($request, \Throwable $e): Response
{// 如果是数据库操作异常if ($e instanceof \think\db\exception\DbException) {$friendlyException = DatabaseOperationException::createFromDbException($e);return json(['code' => 400,'msg' => $friendlyException->getMessage(),'data' => null]);}// 其他异常处理...return parent::render($request, $e);
}