From eeac5b430cdb8145d9a9cdb20e84c036e5a5415b Mon Sep 17 00:00:00 2001
From: zkh <1650697374@qq.com>
Date: Wed, 31 Dec 2025 11:53:04 +0800
Subject: [PATCH] =?UTF-8?q?fix(web):=20=E4=BF=AE=E5=A4=8D=E5=85=A8?=
 =?UTF-8?q?=E5=B1=80=E5=BC=82=E5=B8=B8=E5=A4=84=E7=90=86=E5=99=A8=E5=B9=B6?=
 =?UTF-8?q?=E6=9B=B4=E6=96=B0=E7=89=88=E6=9C=AC=E5=8F=B7?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加 ValidationException 异常处理支持
- 扩展异常处理器以捕获 RuntimeException
- 为 BindException 添加文档注释
- 新增 ValidationException 专门处理方法
- 更新父项目及所有子模块版本从 1.5.2 到 1.5.3
---
 pom.xml                                            |  2 +-
 zkh-common/pom.xml                                 |  2 +-
 zkh-data/pom.xml                                   |  2 +-
 zkh-file/pom.xml                                   |  2 +-
 zkh-log/pom.xml                                    |  2 +-
 zkh-web/pom.xml                                    |  2 +-
 .../jcfd/web/config/GlobalExceptionHandler.java    | 14 ++++++++++++--
 7 files changed, 18 insertions(+), 8 deletions(-)

diff --git a/pom.xml b/pom.xml
index 51cc6e3..ba001d2 100644
--- a/pom.xml
+++ b/pom.xml
@@ -6,7 +6,7 @@
 
     <groupId>vip.jcfd</groupId>
     <artifactId>zkh-framework</artifactId>
-    <version>1.5.2</version>
+    <version>1.5.3</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 da79d31..91c7c28 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.5.2</version>
+        <version>1.5.3</version>
     </parent>
 
     <artifactId>zkh-common</artifactId>
diff --git a/zkh-data/pom.xml b/zkh-data/pom.xml
index e99a52a..4795d31 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.5.2</version>
+        <version>1.5.3</version>
     </parent>
 
     <artifactId>zkh-data</artifactId>
diff --git a/zkh-file/pom.xml b/zkh-file/pom.xml
index 1ebc98e..2f83daa 100644
--- a/zkh-file/pom.xml
+++ b/zkh-file/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>vip.jcfd</groupId>
         <artifactId>zkh-framework</artifactId>
-        <version>1.5.2</version>
+        <version>1.5.3</version>
     </parent>
 
     <artifactId>zkh-file</artifactId>
diff --git a/zkh-log/pom.xml b/zkh-log/pom.xml
index e3aad7f..2ab14ed 100644
--- a/zkh-log/pom.xml
+++ b/zkh-log/pom.xml
@@ -6,7 +6,7 @@
     <parent>
         <groupId>vip.jcfd</groupId>
         <artifactId>zkh-framework</artifactId>
-        <version>1.5.2</version>
+        <version>1.5.3</version>
     </parent>
 
     <artifactId>zkh-log</artifactId>
diff --git a/zkh-web/pom.xml b/zkh-web/pom.xml
index 296d96d..c9580e5 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.5.2</version>
+        <version>1.5.3</version>
     </parent>
 
     <artifactId>zkh-web</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 c6a9b2a..b969493 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
@@ -1,5 +1,6 @@
 package vip.jcfd.web.config;
 
+import jakarta.validation.ValidationException;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.validation.BindException;
@@ -18,8 +19,8 @@ public class GlobalExceptionHandler {
 
 	private static final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
 
-	@ExceptionHandler(value = Exception.class)
-	public R<String> handleException(Exception e) {
+	@ExceptionHandler(value = {Exception.class, RuntimeException.class})
+	public R<String> handleException(Throwable e) {
 		log.error("服务异常", e);
 		return R.serverError("服务器繁忙，请稍候重试");
 	}
@@ -37,6 +38,9 @@ public class GlobalExceptionHandler {
 	}
 
 
+	/**
+	 * Handles bind exceptions; logs and returns formatted field errors
+	 */
 	@ExceptionHandler(value = BindException.class)
 	public R<String> handleBindException(BindException e) {
 		log.error("接口入参校验失败", e);
@@ -44,4 +48,10 @@ public class GlobalExceptionHandler {
 		List<FieldError> fieldErrors = e.getBindingResult().getFieldErrors();
 		return R.error(String.join("。\n", fieldErrors.stream().map(FieldError::getDefaultMessage).toList()));
 	}
+
+	@ExceptionHandler(value = ValidationException.class)
+	public R<String> handleValidationException(ValidationException e) {
+		log.error("接口入参校验失败", e);
+		return R.error(e.getMessage());
+	}
 }