java静态检查必须硬性限制继承深度≤3层，超4级链触发error中断构建，并提供组合重构路径。
要让Java静态代码检查工具真正管住继承深度，关键不是加个规则就完事——得在编译前就卡死超深继承链，不通过直接报错阻断构建，同时给开发人员明确的重构路径。
继承深度必须被硬性限制在3层以内
超过class A extends B、B extends C、C extends D（即4级类链）就属于高风险设计：可读性断崖下降、修改一处可能波及多层、Mock测试成本陡增。这不是风格建议，是架构红线。
- 检查范围锁定为所有
EXTENDS_CLAUSE节点，递归向上追溯父类声明，统计实际继承层级（排除java.lang.Object和接口实现） - 若深度 ≥ 4，且父类非白名单类（如
BaseEntity、AbstractService等经架构组审批的基类），立即触发ERROR级别中断 - 允许单层抽象类作为“承重梁”，但禁止连续两层及以上抽象类嵌套（如
AbstractController → AbstractRestController → MyController）
用自研Checkstyle模块实现AST级深度扫描
靠正则匹配类声明或简单注释解析极易漏判，必须基于语法树做语义穿透：
- 继承
AbstractCheck，监听EXTENDS_CLAUSEtoken，获取其IDENT子节点（父类名） - 通过
ClassTree或CompilationUnit上下文，加载父类的完整类定义（需配合ClassLoader或源码解析器） - 构建继承路径栈，逐层解析
extends关系，跳过final类和@Deprecated基类 - 遇到泛型父类（如
BaseService<t></t>）时，只计类型声明层级，不展开类型参数
Maven与IDE双通道强制落地
规则生效的前提是没人能绕过去：
- Maven配置中设置
<failsonerror>true</failsonerror>，绑定到compile阶段而非validate，确保javac之前就拦截 -
checkstyle.xml中启用模块并设阈值：<module name="ProhibitDeepInheritance"><property name="maxInheritanceDepth" value="3"></property><property name="whitelistClasses" value="com.example.base.BaseEntity,com.example.core.AbstractService"></property></module>
- IDEA中Checkstyle插件必须勾选“Scan opened files automatically”，错误行标红且禁止提交（Git hook联动校验）
配套重构动作必须具体可执行
只说“别继承太深”没用，要给出安全出口：
- 检测到4层继承时，提示模板：将中间层拆为组合关系（如把
AbstractOrderProcessor中的通用逻辑抽为OrderValidationHelper，原类改用private final OrderValidationHelper helper持有） - 对已存在的超深链，允许临时豁免，但需在
suppressions.xml中精确到行号，并关联Jira任务编号（如PROJ-1234），整改时限≤5个工作日 - 提供自动重构脚本：识别
extends X且X本身也extends Y的链式结构，一键生成组合替换建议（含字段注入、方法委托代码片段）
不复杂但容易忽略——继承深度失控往往从一个“暂时方便”的extends开始，静态检查工具要做的，就是把这个“暂时”永远锁死在第一道门。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
