ModelMapper 在处理接口继承链（如 PersonEditInterface extends BaseInterface）时，因反射机制无法正确识别继承自父接口的 getter/setter 方法，导致 getId()/setId() 等基础属性被跳过；根本解法是在每个子接口中显式重复声明父接口的访问器方法，而非依赖继承。
modelmapper 在处理接口继承链（如 `personeditinterface extends baseinterface`）时，因反射机制无法正确识别继承自父接口的 getter/setter 方法，导致 `getid()`/`setid()` 等基础属性被跳过；根本解法是**在每个子接口中显式重复声明父接口的访问器方法**，而非依赖继承。
ModelMapper 的底层字段发现逻辑基于 Java 反射对 当前接口直接声明的方法 进行扫描，而不会递归解析 extends 关系中的父接口方法。这意味着即使 PersonListInterface 继承了 BaseInterface，其 getId() 仍被视为“未在自身定义”，ModelMapper 在构建属性映射时会忽略该方法——尤其当目标 DTO 类（如 PersonEditDTO）也仅实现子接口时，双向方法匹配完全失效。
这解释了为何显式配置 PropertyMap 或 TypeMap 无效：source.getId() 在 lambda 中可调用，是因为编译期类型为 BaseInterface；但 ModelMapper 的运行时类型推断仅检查 proxy.getClass().getInterfaces() 返回的直接实现接口（如 PersonListInterface.class），再从中查找 getId()。若该接口未显式声明该方法，反射即返回空，映射规则自然不生效。
✅ 正确做法：在每个层级接口中显式重声明基类接口的访问器（即“接口方法冗余声明”），确保反射可见性：
public interface BaseInterface {
Long getId();
void setId(Long id);
Boolean getVisible();
void setVisible(Boolean visible);
}
// ✅ 显式包含父接口所有访问器（即使语义重复）
public interface PersonListInterface extends BaseInterface {
// 必须重复声明，否则 ModelMapper 不识别
Long getId();
void setId(Long id);
Boolean getVisible();
void setVisible(Boolean visible);
String getName(); // 子接口特有属性
}
public interface PersonEditInterface extends PersonListInterface {
// 同样需完整重复声明
Long getId();
void setId(Long id);
Boolean getVisible();
void setVisible(Boolean visible);
String getName();
void setName(String name);
}
⚠️ 注意事项：
- 此非代码异味，而是 Java 接口反射的固有限制，Spring Data Neo4j 的代理对象亦遵循此行为；
- 避免使用 @InheritInverseConfiguration 或复杂 Converter 曲线救国——它们无法修复反射层面的元数据缺失；
- 若 DTO 是具体类（非接口实现），需确保其 setId() 方法签名与源接口 getId() 的返回类型严格匹配（如 Long vs long 会导致匹配失败）；
- ModelMapper v3.1.1+ 仍未修复此问题，官方文档亦未明确警示接口继承风险，生产环境务必前置验证映射完整性。
总结：ModelMapper 的接口映射可靠性取决于方法是否在运行时接口类型中直接可见。放弃“优雅继承”，采用显式方法声明，是最稳定、零配置、符合 JVM 规范的解决方案。
