tety公差操作中，如何正确解析并映射多级嵌套公差字段？

Question

在 TETY 公差操作中，常见技术问题是：**多级嵌套公差字段（如 `tolerance.outer.diameter.max`、`tolerance.inner.surface.roughness.ra`）在解析时易因路径分隔符歧义、动态层级缺失或类型不一致导致映射失败**。典型表现为：JSON Schema 校验通过但运行时字段为空；嵌套对象被扁平化丢失结构语义；或不同版本 TETY 规范中 `tolerance.*` 命名策略不统一（如支持点号/下划线/驼峰混合），致使反射映射器误判层级深度。更棘手的是，部分嵌套字段具有条件生效逻辑（如仅当 `type === "shaft"` 时 `outer.diameter` 才有效），而现有解析器未做上下文感知校验，导致无效字段被错误注入公差计算引擎，引发尺寸链传递误差。如何在保持向后兼容前提下，实现带语义校验的动态路径解析与上下文敏感的嵌套字段映射，是工程落地的关键瓶颈。

Answer 1

```html

一、现象层：多级嵌套公差字段的典型失效模式

• 路径分隔符歧义：点号（.）在 JSON 路径中既是层级分隔符，又可能出现在字段名中（如 "tolerance.max-value"），导致 tolerance.outer.diameter.max 被错误切分为 4 层而非语义上的 3 级结构（tolerance → outer → diameter → max）。
• 扁平化映射丢失语义：使用 Jackson 的 @JsonUnwrapped 或 Spring Boot 的 PropertyNamingStrategy.SNAKE_CASE 时，inner_surface_roughness_ra 被映射为顶层字段，破坏 tolerance.inner.surface.roughness.ra 的拓扑约束关系。
• 运行时空值陷阱：JSON Schema 校验仅验证存在性与类型（如 "type": "number"），但未校验 tolerance.outer.diameter 对象是否在 type === "shaft" 下非空——导致下游公差叠加计算传入 NaN。

二、机理层：反射映射器与规范演进的三重错配

错配维度	技术表现	影响范围
命名策略异构	TETY v1.2 用 tolerance_outer_diameter_max；v2.0 支持 toleranceOuterDiameterMax 和 tolerance.outer.diameter.max 混合	反射工具（如 ModelMapper）按字面切分路径，误判 outerDiameter 为单层字段
动态层级缺失	同一 tolerance 对象在 type="hole" 时含 bore 子树，在 "shaft" 时含 shaft 子树，但 POJO 类型静态声明为 Map<String, Object>	类型擦除导致泛型无法承载条件分支语义，Jackson 反序列化后丢失结构可追溯性

三、架构层：上下文感知解析引擎设计

核心引入 Schema-Aware Path Resolver (SAPR)，其处理流程如下：

flowchart TD
  A[原始JSON] --> B{SAPR入口}
  B --> C[Tokenize with Contextual Delimiter]
  C --> D[Resolve against TETY Spec Graph]
  D --> E[Apply Conditional Guard: type === 'shaft' ? hasPath('outer.diameter') : false]
  E --> F[Validate Type Consistency per Node]
  F --> G[Build Typed AST with Semantic Anchors]
  G --> H[Inject into Tolerance Calculation Engine]

四、实现层：向后兼容的渐进式升级方案

1. 零侵入适配器模式：封装旧版 ToleranceDTO 为 LegacyToleranceAdapter，通过 @JsonAnyGetter/@JsonAnySetter 拦截所有嵌套路径，交由 SAPR 处理；
2. 语义路径注册中心：维护 TETYPathRegistry，支持运行时注册：registry.register("outer.diameter", ToleranceScope.SHAFT, Double.class)；
3. 条件校验 DSL：定义轻量规则语言 when(type == 'shaft').require('outer.diameter.max').as(Double.class)，编译为 AST 并嵌入解析器执行链；
4. 降级兜底机制：当 SAPR 遇未知路径时，自动 fallback 至传统反射映射，并记录 WARN: LegacyFallback[path=tolerance.inner.surface.roughness.ra] 日志供审计。

五、验证层：端到端语义一致性保障

构建三阶验证矩阵：

验证层级	工具/方法	覆盖问题
Schema 层	扩展 JSON Schema draft-07：添加 x-tety-context 和 x-tety-condition 自定义关键字	条件生效逻辑缺失
运行时层	基于 ByteBuddy 的字段访问增强：拦截 ToleranceEngine.calculate() 前对 getEffectiveFields() 执行实时语义校验	无效字段注入计算引擎

```