You need to enable JavaScript to run this app. XPages OpenNTF Domino中设置Authors类型Item抛key cannot be 0异常排查
优惠活动
大模型
产品
解决方案
定价
更多

XPages OpenNTF Domino中设置Authors类型Item抛key cannot be 0异常排查

报错根因定位

从异常调用链逐层拆解,错误发生的完整流程为:

  1. 代码执行authorFieldCommittee.setAuthors(true)时,OpenNTF Domino封装层会先校验当前Item的字段属性标记,依次触发isReadersNamesAuthors()、hasFlag()、isNames()系列内部方法
  2. 上述校验方法需要获取Item底层绑定的原生NotesItem委托对象,因此调用getDelegate()方法触发Item实例的resurrect()复活逻辑,尝试重新关联底层原生对象
  3. 复活逻辑会将重新获取的原生对象写入Domino参考缓存,写入时检测到传入的缓存键值为0,直接抛出java.lang.IllegalArgumentException: key cannot be 0异常

OpenNTF Domino参考缓存的底层规则:对原生Notes对象的缓存统一使用原生对象的内存句柄值作为唯一key,正常存活的原生对象句柄值永远不会为0;只有对象被释放、句柄被回收时,句柄值才会被重置为0,这时候触发缓存写入就会直接命中该校验错误。

业务代码的直接触发诱因

原有业务代码里存在两次连续调用同参数doc.replaceItemValue(fieldName, matter.getCommAuthors())的冗余操作:

  • 第一次调用方法时,会在文档上下文创建/替换对应Item,返回第一个有效Item实例,但该实例的返回值没有被代码接收,没有被后续逻辑使用
  • 紧接着第二次调用完全相同参数的replaceItemValue时,OpenNTF封装层会直接销毁第一次生成的Item实例的底层原生委托,将文档上下文中的同名字段对象标记为悬空失效状态
  • 第二次调用返回的Item实例,因为连续替换的时序冲突,内部持有的原生对象句柄已经被前置操作重置为0,后续调用setAuthors(true)触发缓存写入逻辑时,就会直接触发key为0的校验报错。

修复方案

去掉冗余的重复replaceItemValue调用,仅保留一次方法调用拿到有效Item实例后直接设置Authors属性即可:

matter.setCommAuthors(getAuthorsCommittee(matter));
if (null != matter.getCommAuthors()) {
    String fieldName = "CommAuthors";
    // 单次调用获取有效Item实例,避免重复替换导致的对象句柄失效
    Item authorFieldCommittee = doc.replaceItemValue(fieldName, matter.getCommAuthors());
    authorFieldCommittee.setAuthors(true);
}

内容的提问来源于stack exchange,提问作者Patrick Kwinten

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 19:57:02