IntelliJ中Spring Boot的Controller等类已使用却显示未使用的解决方法

一、确保项目被IDE正确识别为Spring Boot类型 #

• 打开File > Project Structure，进入Project Settings > Modules，检查当前模块的框架类型是否为Spring Boot。若不是，右键模块选择Add Framework Support，勾选Spring Boot完成配置。
• 确认项目根目录的pom.xml（Maven）或build.gradle（Gradle）中包含Spring Boot核心依赖（如spring-boot-starter-web），IDE会通过依赖自动识别项目类型。

二、修正Spring组件扫描范围 #

• 检查启动类的@SpringBootApplication注解：它默认扫描启动类所在包及其子包的组件。如果你的Controller/Service/Repository不在该范围内，手动指定扫描路径：

  @SpringBootApplication(scanBasePackages = "com.your.project.package")
  

• 按需添加@ComponentScan、@EnableJpaRepositories（使用JPA时）、@EntityScan等注解，明确组件的扫描范围。

三、调整IDE的未使用检测规则 #

若确认组件已被使用但IDE误报，可修改检测设置：

• 打开File > Settings > Editor > Inspections（Windows/Linux）或IntelliJ IDEA > Settings > Editor > Inspections（Mac）。
• 定位到Java > Declaration redundancy > Unused declaration，展开选项。
• 取消勾选标注Spring注解（@Controller/@Service/@Repository等）类的未使用检测，或把警告级别从Warning改为Info，也可直接禁用该检测项。
• 针对单个类，右键选择Suppress Inspection > For class，单独关闭该类的未使用警告。

四、刷新重建项目 #

• 点击IDE右侧的Maven/Gradle面板，执行Reload All Maven Projects（Maven）或Reload Gradle Project（Gradle），重新加载项目依赖与结构。
• 执行Build > Rebuild Project，清理编译缓存并重新编译，解决缓存导致的识别异常。

内容的提问来源于stack exchange，提问作者mattsmith5