通过 checkstyle 的 `illegaltype` 规则可精准拦截新代码对指定类（如 `abc.something.mycomponent`）的引用，配合抑制配置（suppression）灵活豁免遗留代码，实现渐进式治理。

在 Java Maven 项目中，若需阻止新开发代码引入特定类（例如已标记为“遗留”的 abc.something.MyComponent），同时又不能立即清理全部历史调用，推荐采用 静态代码分析 + 构建时强制校验 的方案。相比 maven-enforcer-plugin（其擅长依赖约束而非源码级类型使用控制），Checkstyle 的 IllegalType 检查器更精准、轻量且开箱即用。

✅ 配置步骤

1. 引入 Maven Checkstyle 插件（pom.xml）：

   <build>
   <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-checkstyle-plugin</artifactId>
      <version>3.4.0</version>
      <configuration>
        <configLocation>checkstyle.xml</configLocation>
        <suppressionsLocation>suppressions.xml</suppressionsLocation>
        <failOnViolation>true</failOnViolation> <!-- 构建失败触发阻断 -->
        <includeTestSourceDirectory>true</includeTestSourceDirectory>
      </configuration>
      <executions>
        <execution>
          <id>check-style</id>
          <phase>compile</phase>
          <goals>
            <goal>check</goal>
          </goals>
        </execution>
      </executions>
    </plugin>
   </plugins>
   </build>

2. 定义核心规则（checkstyle.xml）：

   

   windows-shell-syntax

   在 Windows 上执行终端命令，或对比 Windows 与 Linux 的 Shell 语法时使用。建议先检测当前 Shell 是 PowerShell 还是 cmd.exe，再给出相应命令……

   下载

   <?xml version="1.0"?>
   <!DOCTYPE module PUBLIC
    "-//Checkstyle//DTD Checkstyle Configuration 1.3//EN"
    "https://checkstyle.org/dtds/configuration_1_3.dtd">
   <module name="Checker">
   <module name="TreeWalker">
    <module name="IllegalType">
      <property name="illegalClassNames" value="abc.something.MyComponent"/>
      <property name="severity" value="error"/>
    </module>
   </module>
   </module>

   该配置将在编译阶段扫描所有 .java 文件，一旦发现 new MyComponent()、MyComponent.class、import abc.something.MyComponent 等直接引用即报错。

3. 安全豁免遗留代码（suppressions.xml）：

   <?xml version="1.0"?>
   <!DOCTYPE suppressions PUBLIC
    "-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN"
    "https://checkstyle.org/dtds/suppressions_1_2.dtd">
   <suppressions>
   <!-- 允许 legacy/ 目录下所有文件使用 MyComponent -->
   <suppress checks="IllegalType" files=".*[/\]legacy[/\].*.java"/>
   <!-- 或按具体类名精确豁免 -->
   <suppress checks="IllegalType" files="LegacyService.java" lines="42-45"/>
   </suppressions>

   ⚠️ 注意：suppressions.xml 路径需与插件配置中 suppressionsLocation 一致；文件路径支持正则，推荐用 [/\] 兼容 Windows/Linux。

? 补充说明

• 作用范围明确：IllegalType 拦截的是 类型声明位置 的引用（变量声明、参数、返回值、泛型边界等），不覆盖反射调用（如 Class.forName("abc.something.MyComponent")），后者需结合 ForbiddenApis 插件增强。
• 零侵入开发体验：IDEA/Eclipse 可通过 Checkstyle 插件实时高亮违规代码，开发者在编码阶段即可感知。
• 渐进式演进：初始设 failOnViolation=false 仅生成报告，确认无误后再启用构建阻断，降低落地阻力。

综上，Checkstyle IllegalType 是平衡管控力度与迁移成本的最佳实践——它不修改运行时行为，却能在代码提交前守住架构边界。