From 1f3fea8277e241accd34396b196c7815c6139cf6 Mon Sep 17 00:00:00 2001
From: zkh <1650697374@qq.com>
Date: Sun, 7 Dec 2025 18:19:29 +0800
Subject: [PATCH] =?UTF-8?q?feat(file):=20=E6=B7=BB=E5=8A=A0=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6=E4=B8=8A=E4=BC=A0=E6=8E=A5=E5=8F=A3=E5=8F=82=E6=95=B0?=
 =?UTF-8?q?=E5=90=8D=E7=A7=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 为 FileController 的 upload 方法 MultipartFile 参数添加 name 属性
- 在 zkh-common 模块中引入 jakarta.validation-api 和 jakarta.annotation-api 依赖
- 将 springdoc-openapi-common 依赖升级为 springdoc-openapi-starter-webmvc-ui 并指定版本
- 为多个模块的 maven-compiler-plugin 配置添加 -parameters 编译参数
- 移除 zkh-file 和 zkh-web 模块中重复或不必要的 springdoc-openapi 依赖声明
---
 zkh-common/pom.xml                            | 21 ++++++++++++++++++-
 zkh-data/pom.xml                              |  3 +++
 zkh-file/pom.xml                              |  9 +++-----
 .../jcfd/file/controller/FileController.java  |  2 +-
 zkh-log/pom.xml                               | 10 +++++++++
 zkh-web/pom.xml                               |  9 +++-----
 6 files changed, 40 insertions(+), 14 deletions(-)

diff --git a/zkh-common/pom.xml b/zkh-common/pom.xml
index 604acc3..78185f5 100644
--- a/zkh-common/pom.xml
+++ b/zkh-common/pom.xml
@@ -14,6 +14,14 @@
     <description>Common utilities and base classes for ZKH framework</description>
 
     <dependencies>
+        <dependency>
+            <groupId>jakarta.validation</groupId>
+            <artifactId>jakarta.validation-api</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>jakarta.annotation</groupId>
+            <artifactId>jakarta.annotation-api</artifactId>
+        </dependency>
         <dependency>
             <groupId>jakarta.persistence</groupId>
             <artifactId>jakarta.persistence-api</artifactId>
@@ -32,12 +40,23 @@
         </dependency>
         <dependency>
             <groupId>org.springdoc</groupId>
-            <artifactId>springdoc-openapi-common</artifactId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
+            <version>2.8.14</version>
         </dependency>
     </dependencies>
 
     <build>
         <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.14.1</version>
+                <configuration>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
+                </configuration>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
diff --git a/zkh-data/pom.xml b/zkh-data/pom.xml
index c3b7075..caf900b 100644
--- a/zkh-data/pom.xml
+++ b/zkh-data/pom.xml
@@ -46,6 +46,9 @@
                             <version>1.18.42</version>
                         </path>
                     </annotationProcessorPaths>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
                 </configuration>
             </plugin>
             <plugin>
diff --git a/zkh-file/pom.xml b/zkh-file/pom.xml
index 3aad25f..1b4d9d4 100644
--- a/zkh-file/pom.xml
+++ b/zkh-file/pom.xml
@@ -39,12 +39,6 @@
             <artifactId>hutool-all</artifactId>
             <version>5.8.41</version>
         </dependency>
-        <dependency>
-            <groupId>org.springdoc</groupId>
-            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-            <version>2.8.14</version>
-            <scope>provided</scope>
-        </dependency>
     </dependencies>
 
     <build>
@@ -60,6 +54,9 @@
                             <artifactId>spring-boot-configuration-processor</artifactId>
                         </path>
                     </annotationProcessorPaths>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
                 </configuration>
             </plugin>
             <plugin>
diff --git a/zkh-file/src/main/java/vip/jcfd/file/controller/FileController.java b/zkh-file/src/main/java/vip/jcfd/file/controller/FileController.java
index 5087420..1242ea5 100644
--- a/zkh-file/src/main/java/vip/jcfd/file/controller/FileController.java
+++ b/zkh-file/src/main/java/vip/jcfd/file/controller/FileController.java
@@ -40,7 +40,7 @@ public class FileController {
 					schema = @Schema(implementation = R.class)))
 	@PostMapping
 	public R<FileInfo> upload(
-			@Parameter(description = "要上传的文件", required = true)
+			@Parameter(description = "要上传的文件", required = true, name = "file")
 			MultipartFile file) {
 		try {
 			FileInfo upload = fileUploadService.upload(file);
diff --git a/zkh-log/pom.xml b/zkh-log/pom.xml
index 74a32e8..5d6874c 100644
--- a/zkh-log/pom.xml
+++ b/zkh-log/pom.xml
@@ -26,6 +26,16 @@
 
     <build>
         <plugins>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-compiler-plugin</artifactId>
+                <version>3.14.1</version>
+                <configuration>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
+                </configuration>
+            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-source-plugin</artifactId>
diff --git a/zkh-web/pom.xml b/zkh-web/pom.xml
index 52606c2..d895c40 100644
--- a/zkh-web/pom.xml
+++ b/zkh-web/pom.xml
@@ -43,12 +43,6 @@
             <groupId>com.fasterxml.jackson.datatype</groupId>
             <artifactId>jackson-datatype-jsr310</artifactId>
         </dependency>
-        <dependency>
-            <groupId>org.springdoc</groupId>
-            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
-            <version>2.8.14</version>
-            <scope>provided</scope>
-        </dependency>
     </dependencies>
 
     <build>
@@ -64,6 +58,9 @@
                             <artifactId>spring-boot-configuration-processor</artifactId>
                         </path>
                     </annotationProcessorPaths>
+                    <compilerArgs>
+                        <arg>-parameters</arg>
+                    </compilerArgs>
                 </configuration>
             </plugin>
             <plugin>