From a7e1c26853c98d42bfc59bf69d0d78f2cf531d3b Mon Sep 17 00:00:00 2001
From: zkh <1650697374@qq.com>
Date: Mon, 24 Nov 2025 15:24:59 +0800
Subject: [PATCH] =?UTF-8?q?feat(web):=20=E6=B7=BB=E5=8A=A0=E6=8E=A5?=
 =?UTF-8?q?=E5=8F=A3=E5=8F=82=E6=95=B0=E6=A0=A1=E9=AA=8C=E5=BC=82=E5=B8=B8?=
 =?UTF-8?q?=E5=A4=84=E7=90=86?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 在 GlobalExceptionHandler 中新增 BindException 处理方法
- 返回字段校验错误信息，提升接口调试体验
- 引入 spring-boot-starter-validation 依赖
- 升级 zkh-framework 版本至 1.4
- 同步升级 zkh-common、zkh-data 和 zkh-web 模块版本
---
 pom.xml                                            |  2 +-
 zkh-common/pom.xml                                 |  2 +-
 zkh-data/pom.xml                                   |  2 +-
 zkh-web/pom.xml                                    |  6 +++++-
 .../jcfd/web/config/GlobalExceptionHandler.java    | 14 ++++++++++++++
 5 files changed, 22 insertions(+), 4 deletions(-)

diff --git a/pom.xml b/pom.xml
index 3083cff..6710ef7 100644
--- a/pom.xml
+++ b/pom.xml
@@ -6,7 +6,7 @@
 
     <groupId>vip.jcfd</groupId>
     <artifactId>zkh-framework</artifactId>
-    <version>1.3</version>
+    <version>1.4</version>
     <packaging>pom</packaging>
     <name>ZKH Framework</name>
     <description>A Java framework for ZKH applications</description>
diff --git a/zkh-common/pom.xml b/zkh-common/pom.xml
index cbf5979..2efd408 100644
--- a/zkh-common/pom.xml
+++ b/zkh-common/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>vip.jcfd</groupId>
         <artifactId>zkh-framework</artifactId>
-        <version>1.3</version>
+        <version>1.4</version>
     </parent>
 
     <artifactId>zkh-common</artifactId>
diff --git a/zkh-data/pom.xml b/zkh-data/pom.xml
index 617a993..7bb4ad8 100644
--- a/zkh-data/pom.xml
+++ b/zkh-data/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>vip.jcfd</groupId>
         <artifactId>zkh-framework</artifactId>
-        <version>1.3</version>
+        <version>1.4</version>
     </parent>
 
     <artifactId>zkh-data</artifactId>
diff --git a/zkh-web/pom.xml b/zkh-web/pom.xml
index ff07eda..48b5718 100644
--- a/zkh-web/pom.xml
+++ b/zkh-web/pom.xml
@@ -7,7 +7,7 @@
     <parent>
         <groupId>vip.jcfd</groupId>
         <artifactId>zkh-framework</artifactId>
-        <version>1.3</version>
+        <version>1.4</version>
     </parent>
 
     <artifactId>zkh-web</artifactId>
@@ -23,6 +23,10 @@
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-web</artifactId>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-validation</artifactId>
+        </dependency>
         <dependency>
             <groupId>org.springframework.boot</groupId>
             <artifactId>spring-boot-starter-security</artifactId>
diff --git a/zkh-web/src/main/java/vip/jcfd/web/config/GlobalExceptionHandler.java b/zkh-web/src/main/java/vip/jcfd/web/config/GlobalExceptionHandler.java
index a61251c..0bea6c3 100644
--- a/zkh-web/src/main/java/vip/jcfd/web/config/GlobalExceptionHandler.java
+++ b/zkh-web/src/main/java/vip/jcfd/web/config/GlobalExceptionHandler.java
@@ -2,12 +2,17 @@ package vip.jcfd.web.config;
 
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
+import org.springframework.validation.BindException;
+import org.springframework.validation.FieldError;
 import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 import org.springframework.web.servlet.resource.NoResourceFoundException;
 import vip.jcfd.common.core.BizException;
 import vip.jcfd.common.core.R;
 
+import java.util.List;
+
+
 @RestControllerAdvice
 public class GlobalExceptionHandler {
 
@@ -30,4 +35,13 @@ public class GlobalExceptionHandler {
         log.error("404异常", e);
         return new R<>(404, "您访问的地址不存在", false, null);
     }
+
+
+    @ExceptionHandler(value = BindException.class)
+    public R<String> handleBindException(BindException e) {
+        log.error("接口入参校验失败", e);
+
+        List<FieldError> fieldErrors = e.getBindingResult().getFieldErrors();
+        return R.error(String.join("。\n", fieldErrors.stream().map(FieldError::getDefaultMessage).toList()));
+    }
 }