Agent 查到的长编号为什么变了:订单号和记录 ID 怎样完整传递
Agent查到的订单号发生变化,先检查标识是否被当成数字转换。业务编号的作用是定位同一对象,通常不需要算术;前导零、大小写和长整数精度都可能在JSON、浏览器或表格中丢失。本文交付合成编号往返夹具,目的是逐字核对接口链路,而不是让模型猜回原编号。
把标识与可计算数值分开
合成订单号包含有前导零的字符串、超过常见浏览器安全整数范围的十进制文本,以及含字母的大小写敏感编号。它们都应按合同作为标识处理。数据库列是数字并不自动说明前端可以用任意数字类型承接;反过来,JSON写成字符串也不代表各层不会主动转成Number。
先列数据库值、API表示、浏览器状态、工具参数和最终回查值。每层记录实际类型与原始文本,不能只看页面格式化后的标签。某层已经舍入,后来再加引号只能保留错误结果,不会恢复丢失位数;修复要回到权威来源读取原标识。
官方映射说明了精度边界
ProtoJSON格式文档将int64等类型映射为十进制字符串,以避免JSON消费者的精度问题。它提供协议映射依据,不代表所有业务API天然遵循相同规则。PostgreSQL数值类型也列出整数与精确数值类型,但标识的业务含义仍需单独定义。
对有前导零的编号,通常需要字符串字段而不是整数列。对历史系统强制使用整数主键的情况,可以在接口适配层明确十进制字符串表示,保证查询时按受控类型转换,不让模型生成任意表达式。不要把显示格式补零当成永久主键修复,除非权威编码规则确实如此。
用夹具做每一段往返比较
下载编号精度与格式测试包。附件把原始十进制内容保存为字符串,避免测试材料自身先发生舍入,并留出数据库、API、浏览器与工具回传的实际结果栏。用同一输入贯穿完整路径,要求目标系统查到的仍是原对象。
测试包括前导零、长整数、大小写、前后空白与空编号。是否去除空白、是否忽略大小写必须由编码规则决定,不能每一层自己做友好归一化。字段允许空值时明确未知;不允许时先拒绝,不能把空字符串自动转换成零号对象。
禁止用相似对象补救
编号失真后,系统可能查不到记录,也可能碰巧命中另一条合法记录。不能退而用客户名、金额或相似编号模糊匹配后宣称查到了原对象。应记录标识不一致并停止依赖它的动作,给用户查看原始输入和重新选择对象的受控入口。
模型输出编号时也按源字段复制,不让生成过程改写、科学计数或插入分隔符。若展示为了易读增加空格,应保存独立原值,提交时使用原值而不是从显示文字再解析。复制按钮、下载文件与工具调用都需要分别核对,不能只验证屏幕上看起来正确。
回查与验收保留原证据
每条夹具保存源值、各层表示与最终对象别名,逐字符比较而非数值相等。两个字符串在数学上可能相等,却是不同业务编码;反之同一数据库整数经过不同格式显示,也可能应映射为同一对象,必须由合同解释。实测截图只作辅助,原始响应和请求参数更适合定位变化。
修复后从源系统重新读取并测试,不能使用已经失真的中间缓存当基准。若历史数据受影响,另行盘点范围并由业务方决定修正方式,不在普通联调里批量修改真实订单。本文附件均是合成编号,没有访问或写入客户系统。
相关接口范围可读ERP接入清单,总体设计归入流程自动化。通过定制咨询提供脱敏字段类型、原始响应与失真后的请求,可定位转换层并定义标识往返验收。