查看代理仓日志
更新时间：2026-07-31
1. 操作场景
代理仓日志页用于查看 GWMS 与代理仓之间的请求和响应记录。它回答的是“发了什么、回了什么”，适合在同步任务已经提示异常后，继续定位是哪一步请求失败、返回了什么结果。
这页适用于仓库实施、运维和排障人员。常见场景包括：
- 已经在《同步任务》看到任务失败，想继续看原始报文；
- 想确认 GWMS 发给代理仓的单号、仓库、SKU、渠道是否正确；
- 想确认入库序列号到底有没有推给代理仓，或者代理仓有没有把入库/出库序列号带回 GWMS；
- 想确认代理仓到底是返回失败、空结果，还是已经处理成功；
- 想按单号或错误关键词快速定位某次接口调用。
建议的排查顺序
- 先看《同步任务》确认任务是等待中、成功还是人工处理。
- 如果任务摘要已经提示是配置、资料或本地动作问题，优先按提示修正。
- 如果需要继续确认接口调用细节，再到日志页看请求体和响应体。
2. 查看日志
2.1 进入日志页面
菜单路径：GWMS-代理仓-日志
页面支持按以下条件搜索：
- 【系统名称】：选择代理仓系统
- 【业务】：选择操作类型，例如推送、取消、查询
- 【业务关键词】：输入单号或 SKU
- 【请求 url】：输入接口地址
- 【请求体】：搜索请求内容
- 【响应体】：搜索响应内容
常用查找方法
- 按单号查：在【业务关键词】输入业务单号或第三方单号。
- 按错误查：在【响应体】输入“失败”“错误”“exception”等关键词。
- 按接口查：在【请求 url】输入接口地址的一部分，缩小范围。
2.2 查看日志详情
点击【查看】按钮，可以看到：
- 请求 url：调用的接口地址
- 请求体：发送的完整内容
- 响应体：代理仓返回的完整内容
系统会自动格式化 JSON 内容，方便查看。
2.3 这页适合回答什么问题
这页更适合确认下面几类问题：
- GWMS 有没有真正把请求发出去；
- 发出去的仓库、单号、SKU、渠道、数量是否正确；
- 发出去的序列号内容是否正确，代理仓对序列号录入、查询、更新返回了什么；
- 代理仓状态回包里有没有带回入库或出库序列号，本地有没有机会把这些序列号回写进 GWMS；
- 代理仓是否已经明确返回成功、失败或空结果；
- 同一个任务在多次自动重试里，返回结果有没有变化。
这页不直接告诉你“业务最终有没有闭环”。 如果代理仓已经返回成功，但本地后续动作失败，最终还是要回到《同步任务》看任务状态和执行摘要。
2.4 序列号问题怎么查日志
如果你查的是序列号问题，建议按下面顺序看：
场景一：怀疑 GWMS 没有把入库序列号推给代理仓
- 先按业务单号查日志。
- 重点看序列号录入、序列号查询、序列号更新这几类请求。
- 确认请求里的仓库、SKU、序列号内容是否正确。
场景二：怀疑代理仓没有把入库序列号回写到 GWMS
- 先按入库单号查入库状态查询日志。
- 确认代理仓回包里有没有带序列号内容。
- 如果回包里根本没有序列号，问题先看代理仓响应。
- 如果回包里有序列号，但 GWMS 没落下来，再结合映射和主流程继续排查。
场景三：怀疑代理仓没有把出库序列号回写到 GWMS
- 先按出库单号查出库状态查询日志。
- 确认代理仓回包里的商品节点有没有带序列号列表。
- 如果回包里有序列号但本地没同步，再回到《同步任务》确认主流程是否已经推进完成。
3. 常见问题
Q：日志和同步任务有什么区别？
A：
- 同步任务：看业务当前走到哪一步，是否成功、等待重试、需要人工处理。
- 日志：看这一步接口具体发了什么、代理仓回了什么。
建议先看同步任务，如果需要定位具体错误原因，再看日志。
Q：日志查不到记录？
A：
- 确认业务是否真的触发了代理仓请求
- 优先用【业务关键词】搜索单号
- 到同步任务页面确认是否创建了任务
Q：响应体没有明显报错，但业务失败了？
A：这通常说明代理仓接口已经返回成功，但后续本地动作没有完成。请回到《同步任务》看执行摘要和错误信息。
Q：日志很多，怎么缩小范围？
A：优先组合使用【系统名称】+【业务关键词】或【请求 url】+【业务】。如果仍然很多，再结合创建时间缩小排查范围。
Q：看完日志后，下一步应该做什么？
A：
- 如果已经看出是配置问题，请回到《代理仓系统》修正。
- 如果已经修正完成，想马上再跑一次，请回到《同步任务》执行【立即同步】。
- 如果是 HPK 专属问题，例如库存口径或当前支持范围，请继续看《HPK 使用说明》。
Q：序列号问题为什么在同步任务里不明显？
A：当前序列号链路不会单独生成一种序列号任务。无论是本地往代理仓推入库序列号，还是代理仓在入库/出库结果里把序列号带回 GWMS，最终都要以日志记录为准，再结合入库或出库任务状态一起判断。