JPOS报错‘Key fields not found’求助，附相关实现代码

这个org.jpos.iso.ISOException: Key fields not found错误是QMUX组件在发送请求时，无法找到用于关联请求和响应的关键标识字段导致的——QMUX需要这些字段来跟踪每一笔请求，确保后续收到的响应能正确匹配到对应的发起请求。结合你提供的配置和代码，我整理了以下排查和解决思路：

1. 先看QMUX的默认key规则 #

你的20_pd_mux.xml没有显式配置key-fields属性，jPOS的QMUX默认会用MTI + 11(STAN) + 37(Retrieval Reference Number)作为请求/响应的匹配key组合。但从你的代码来看，你发送的MTI 1200请求没有设置字段37，这直接导致QMUX无法生成有效的匹配key，从而抛出错误。

快速修复：调整QMUX的key字段配置

修改20_pd_mux.xml，显式指定QMUX使用的key字段。如果你的业务只需要用STAN（字段11）来匹配请求，配置如下：

<mux class="org.jpos.q2.iso.QMUX" logger="Q2" name="pd-mux">
    <in>pd-channel-receive</in>
    <out>pd-channel-send</out>
    <ready>pd-channel.ready</ready>
    <unhandled>pd-unhandled</unhandled>
    <!-- 只使用STAN作为匹配key，可根据业务需求调整 -->
    <property name="key-fields" value="11"/>
</mux>

如果需要保留MTI+STAN的组合，就把key-fields设为：

<property name="key-fields" value="MTI,11"/>

2. 若需保留默认规则，补充缺失的字段37 #

如果你的交易规范要求使用默认的MTI+11+37组合，那需要在请求代码中添加字段37的值：

// 替换为你系统中生成唯一检索参考号的逻辑
m.set(37, transferRequest.getRetrievalReferenceNo());

字段37是Retrieval Reference Number，一般是全局唯一的交易参考号，用于后续对账和请求响应匹配。

3. 验证Packager配置（pd.xml） #

确保cfg/pd.xml中正确定义了所有涉及的key字段（比如字段11、37），字段的类型、长度要符合ISO 8583标准或你的交易规范。例如：

• 字段11（STAN）应该是N6类型（6位数字）
• 字段37应该是N12类型（12位数字）
  如果packager里没有定义这些字段，QMUX也无法从ISOMsg中获取到对应的值。

4. 检查ISOMsg的完整性 #

在发送请求前，可以打印ISOMsg的详细内容，确认配置的key字段已正确设置：

log.info("待发送请求内容：\n{}", m.debugString());

通过debugString()方法可以看到ISOMsg中所有已设置的字段，确保key字段存在且有有效值。

最可能的问题就是QMUX默认需要字段37，但你的请求中没有提供，或者没有配置合适的key字段组合。调整QMUX的key-fields配置，或者补充缺失的字段，应该就能解决这个错误。

内容的提问来源于stack exchange，提问作者Daniel Ameyaw