spring

　　Spring Integration里说的Transformer转换结果为空，通常分成两类情况，一类是你在Transformer里确实返回了null或产出了空payload，另一类是链路走的是请求响应但没有正确产生回复，调用方看到的是空。把这两类先分开，再按输入类型、表达式路径、输出通道与错误通道逐步核对，问题一般能很快收敛到具体配置点。

　　一、Spring Integration Transformer转换结果为空怎么办

　　Transformer本质是把一条消息变成另一条消息，它不是过滤器，也不是吞消息的组件，所以排查时先盯住输入输出的契约，再看链路是否按你预期产生了回复。

　　1、先确认空的具体含义是返回了null还是回复没回来

　　如果你在Transformer方法里返回null，Spring Integration从2.0开始会直接认为这是不合法的转换并抛异常，因为Transformer必须把每条输入转换成有效目标消息，想丢弃消息应该用Filter。

　　2、把输入消息的真实payload类型先看清楚再写映射

　　很多空结果来自类型误判，比如你以为payload是Map或POJO，实际是JSON字符串或字节数组，表达式路径自然取不到值。建议先在Transformer之前加一段日志或wiretap，把payload的类型与关键字段打出来，再决定用fromJson先反序列化还是直接映射。

　　3、核对映射路径是否写在了Message维度还是payload维度

　　在SpEL里多数情况下root是Message，你要取业务字段一般是从payload开始，例如payload.userId；要取header则用headers取值。路径写错层级时看起来就是转换结果空或字段全空。

　　4、确认链路是否需要reply但你没有设置输出或replyChannel

　　如果上游是gateway或某个请求响应调用，Transformer后面必须能把消息送到可回复的通道，要么显式配置output channel，要么让后续端点按replyChannel头去回写，否则调用方会拿不到结果并表现为返回空。

　　5、把异常与空结果区分开来看，优先把错误通道接好

　　Transformer内部抛异常时，Spring Integration会把异常包装成ErrorMessage发到errorChannel，如果你没有配置消费端，可能只看到上游超时或空返回。建议先把errorChannel接到一个明确的日志处理或告警处理上，确保异常不会悄悄变成空结果。

　　6、需要条件丢弃时用Filter，不要用Transformer伪装过滤

　　很多人为了条件分流在Transformer里返回null，结果要么直接异常，要么被你在某处兜底后变成空响应。正确做法是把条件判断写到Filter，过滤掉不需要继续处理的消息，再把剩余消息交给Transformer做转换。

　　二、Spring Integration Transformer映射规则怎么设置

　　映射规则设置要先把输入输出的结构约定好，再选合适的Transformer形态。简单字段重排用表达式，复杂规则用方法式Transformer，涉及JSON或结构化抽取再引入JSON相关能力。

　　1、先定输入与输出契约，明确字段缺失与默认值口径

　　先写清楚输入payload是什么类型，输出要变成什么类型，哪些字段必须有，缺字段是补默认值还是直接走错误通道。契约没定好，映射规则就会不断堆补丁，最后很难维护。

　　2、方法式映射用 Transformer，适合复杂规则与可测试性

　　如果你需要多字段组合、格式化、枚举转换、校验失败抛错，优先用一个带 Transformer的方法来做转换，并明确inputChannel与outputChannel，让链路意图更清晰。

　　3、表达式映射用SpEL，把路径写在payload与headers上

　　字段重命名或取嵌套字段时，用SpEL会更直接，常见写法是从payload取值，从headers取上下文参数。规则建议只做取值与简单拼装，复杂分支尽量下沉到方法里，否则后续改动风险很大。

　　4、JSON输入优先先反序列化，再做字段映射或抽取

　　如果上游给的是JSON字符串，建议先用DSL的JSON转换能力把它变成POJO或Map，再做映射，避免在表达式里一边解析一边映射导致规则难读且容易出空值。

　　5、需要从JSON里按路径取值时用内置jsonPath能力

　　当你只需要抽取JSON中的一小部分字段时，可以用内置的jsonPath相关能力直接按路径取值，用它来做映射比手写解析更稳，也更便于统一路径口径。

　　6、需要对象与Map互转时用内置Object to Map与Map to Object思路

　　当你要把对象摊平成Map给下游用，或者把Map还原成对象时，Spring Integration提供了对象到Map与Map到对象的转换思路，映射键通常用SpEL路径来描述字段来源，这类规则适合做通用适配层。

　　三、把空结果问题从偶发故障变成可定位问题

　　同样是空结果，有的来自输入变化，有的来自规则写错，有的来自链路未回复。要减少返工，建议把观测、失败处理与契约测试一次性补齐。

　　1、在Transformer前后固定输出一份消息摘要

　　至少记录payload类型、关键字段是否存在、消息id与主要header，这样你能快速判断是输入不对还是映射不对，而不是靠猜。

　　2、把错误通道当成正式链路建设，不要只靠控制台堆栈

　　为errorChannel配置明确的处理流，至少做到可检索与可告警，避免异常被吞后让上游看到的只有空。

　　3、对转换失败定义清晰的业务语义

　　是直接失败并终止，还是走补偿通道，还是写入死信队列后人工处理，这三种语义要在团队内统一，否则同一个空值在不同链路里会被理解成不同含义。

　　4、需要丢弃就用Filter，需要转换就用Transformer，职责不要混

　　Transformer返回null会带来异常或不可控的空响应，职责边界清晰后，链路会更稳定，排查也更容易。

　　5、为典型输入样例做映射回归用例

　　准备几组样例覆盖字段齐全、字段缺失、嵌套层级变化、类型不匹配等情况，只验证Transformer输入输出契约是否满足，这类用例能显著降低上线后出现空结果的概率。

　　总结

　　Spring Integration Transformer转换结果为空，优先把空的类型分清，是Transformer返回了null触发异常，还是请求响应链路没有正确产生回复，再按payload类型、SpEL路径、输出通道与errorChannel逐项核对。映射规则设置上，先定输入输出契约，再按复杂度选择 Transformer方法式或SpEL表达式式，遇到JSON用先反序列化或jsonPath抽取的方式，最后用错误通道与样例回归把问题从偶发变成可定位。