升级至San Diego版本后ServiceNow REST API调用报空指针异常

问题复现信息 #

• 调用目的：拉取sc_req_item表报表数据
• 调用命令：

curl --user username:password "https://myurl.service-now.com/api/now/table/sc_req_item?sysparm_display_value=true&sysparm_exclude_reference_link=true&sysparm_limit=1"

• 返回错误：

{"error":{"detail":"NullPointerException Check logs for error trace or enable glide.rest.debug property to verify REST request processing","message":"NullPointerException"},"status":"failure"}

• 触发特征：
  • 实例升级至San Diego版本前接口可正常运行
  • QA、DEV环境同参数调用正常，仅生产环境报错

根因定位&解决步骤 #

这类仅生产环境触发、升级后出现的Table API空指针，90%以上是生产独有的脏数据、配置差异导致，按以下顺序排查即可：

1. 先定位是否为显示值计算环节触发错误
   把请求里的sysparm_display_value=true去掉，发起测试请求：

   curl --user username:password "https://myurl.service-now.com/api/now/table/sc_req_item?sysparm_exclude_reference_link=true&sysparm_limit=1"
   

   如果这个请求能正常返回，直接确定空指针出在引用字段显示值序列化环节——San Diego版本调整了REST API响应序列化的逻辑，对空引用的容错比旧版本低，只要某条返回记录里存在引用字段指向已删除的记录、或者字段字典配置损坏，取显示值时就会抛NPE。
   定位具体问题字段的方法：给请求加sysparm_fields参数，先只传sys_id,number这类无引用的基础字段调用，确认正常后逐批追加其他字段，每次加1-2个字段测试，就能快速定位到触发报错的具体字段。定位到字段后，排查生产环境该字段关联的记录是否存在脏数据、字段字典配置是否和DEV/QA一致即可。
2. 开启debug日志定位精确报错点
   按照错误提示，在生产实例系统属性里临时添加glide.rest.debug = true，复现一次报错请求后去应用节点日志里查对应trace，日志会直接打印空指针触发的具体脚本行、字段处理逻辑，不需要逐字段猜。定位完成后记得把debug属性关掉，避免产生多余日志占用资源。
3. 排查生产独有的脚本/ACL配置差异
   如果去掉sysparm_display_value依然报错，对比DEV/QA和生产环境sc_req_item表上的以下配置：
   • 查询触发的业务规则（Business Rule），特别是执行时机为before query、after query的生产独有脚本，检查是否存在未做空值判断就直接取对象属性的逻辑
   • 针对sc_req_item表、REST API访问路径的ACL规则，确认升级后是否有规则脚本逻辑未做兼容
   • 升级后是否有未完成的应用更新批量修复任务，San Diego版本Request Management应用升级后如果遗漏执行后处理脚本，会导致表关联配置损坏，触发这类空指针。

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