chore(usr): 配置 checkstyle.xml 并修复 5 处 lint 违规

- 添加 backend/checkstyle.xml（Spring Boot 友好规则集，替换过严的 sun_checks.xml） - pom.xml 配置 maven-checkstyle-plugin 使用自定义规则 - 修复: Application.java 未使用 import - 修复: AuthController / UserController 通配符 import 改为精确 import - 修复: GlobalExceptionHandler 两处未使用 import

chore(usr): 配置 checkstyle.xml 并修复 5 处 lint 违规
- 添加 backend/checkstyle.xml（Spring Boot 友好规则集，替换过严的 sun_checks.xml） - pom.xml 配置 maven-checkstyle-plugin 使用自定义规则 - 修复: Application.java 未使用 import - 修复: AuthController / UserController 通配符 import 改为精确 import - 修复: GlobalExceptionHandler 两处未使用 import
zichun
1 parent 0d71a3c6
Showing 6 changed files with 71 additions and 5 deletions
backend/checkstyle.xml
backend/pom.xml
backend/src/main/java/com/example/erp/Application.java
backend/src/main/java/com/example/erp/common/exception/GlobalExceptionHandler.java
backend/src/main/java/com/example/erp/module/usr/controller/AuthController.java
backend/src/main/java/com/example/erp/module/usr/controller/UserController.java
+<?xml version="1.0"?>
+<!DOCTYPE module PUBLIC
+    "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
+    "https://checkstyle.org/dtds/configuration_1_3.dtd">
+<!--
+  项目 checkstyle 规则（Spring Boot + Lombok 友好，不使用 sun_checks.xml 的过严规则）
+  规则原则：检查明显的代码问题，不干预 Lombok 注解生成类、不要求 final 参数、不限制行长。
+-->
+<module name="Checker">
+  <property name="charset" value="UTF-8"/>
+  <property name="severity" value="error"/>
+  <property name="fileExtensions" value="java"/>
+
+  <module name="TreeWalker">
+    <!-- 未使用的 import -->
+    <module name="UnusedImports"/>
+    <!-- 重复 import -->
+    <module name="RedundantImport"/>
+    <!-- 通配符 import（java.util.* 等）-->
+    <module name="AvoidStarImport"/>
+
+    <!-- 左大括号位置 -->
+    <module name="LeftCurly"/>
+    <!-- 空代码块（空 catch 需有注释）-->
+    <module name="EmptyBlock">
+      <property name="option" value="text"/>
+    </module>
+
+    <!-- switch 缺少 default -->
+    <module name="MissingSwitchDefault"/>
+
+    <!-- == 比较 String 字面量 -->
+    <module name="StringLiteralEquality"/>
+
+    <!-- 多余的分号 -->
+    <module name="EmptyStatement"/>
+
+    <!-- 修饰符顺序 (public static final ...) -->
+    <module name="ModifierOrder"/>
+
+    <!-- 不允许 System.out.println（生产代码用 logger）-->
+    <module name="Regexp">
+      <property name="format" value="System\.(out|err)\.print"/>
+      <property name="illegalPattern" value="true"/>
+      <property name="message" value="请使用 logger 而非 System.out/err.print"/>
+    </module>
+  </module>
+</module>
@@ -122,6 +122,16 @@
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
+                <artifactId>maven-checkstyle-plugin</artifactId>
+                <configuration>
+                    <configLocation>checkstyle.xml</configLocation>
+                    <consoleOutput>true</consoleOutput>
+                    <failsOnError>true</failsOnError>
+                    <includeTestSourceDirectory>false</includeTestSourceDirectory>
+                </configuration>
+            </plugin>
+            <plugin>
+                <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
                 <configuration>
                     <argLine>
@@ -2,7 +2,6 @@ package com.example.erp;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
-import org.springframework.boot.context.properties.EnableConfigurationProperties;
 @SpringBootApplication
 public class Application {
@@ -2,11 +2,9 @@ package com.example.erp.common.exception;
 import com.example.erp.common.response.Result;
 import lombok.extern.slf4j.Slf4j;
-import org.springframework.http.HttpStatus;
 import org.springframework.validation.FieldError;
 import org.springframework.web.bind.MethodArgumentNotValidException;
 import org.springframework.web.bind.annotation.ExceptionHandler;
-import org.springframework.web.bind.annotation.ResponseStatus;
 import org.springframework.web.bind.annotation.RestControllerAdvice;
 @Slf4j
@@ -8,7 +8,11 @@ import com.example.erp.module.usr.vo.BrandVO;
 import com.example.erp.module.usr.vo.LoginVO;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RestController;
 import java.util.List;
 import java.util.Map;
@@ -15,7 +15,14 @@ import com.example.erp.module.usr.vo.UserUpdateRespVO;
 import jakarta.validation.Valid;
 import lombok.RequiredArgsConstructor;
 import org.springframework.security.core.annotation.AuthenticationPrincipal;
-import org.springframework.web.bind.annotation.*;
+import org.springframework.web.bind.annotation.GetMapping;
+import org.springframework.web.bind.annotation.PathVariable;
+import org.springframework.web.bind.annotation.PostMapping;
+import org.springframework.web.bind.annotation.PutMapping;
+import org.springframework.web.bind.annotation.RequestBody;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.RestController;
 import java.util.List;