问题处置：按现象判断原因，再决定处理或升级
问题处置 · 替换落地
替换落地中的问题往往不是单一原因造成的。资料缺口、接口不通、环境差异和验收分歧四类现象，处理顺序各不相同。本页把每类问题的现象、原因判断、处理步骤和升级路径排开，方便项目对接人先定位环节，再决定继续排查还是升级。
先记录现象，再判断原因
问题处置的起点不是猜测原因，而是把现象写清楚：什么操作、在哪个环境、出现什么结果、是否可重复。现象记录完整，后续判断才有依据；记录缺失时，双方容易在原因归属上反复讨论。
下面四类问题覆盖替换落地中的常见情形。每类都按现象、原因判断、处理步骤、升级路径四段排列，处理步骤走完后仍可复现，再进入升级。
资料缺口
所属环节：需求确认与选型适配
现象
- 接口清单只有名称，没有字段说明和调用频率。
- 环境清点缺少版本、部署方式和依赖组件信息。
- 同一份资料在不同沟通中出现两个版本，无法确认以哪份为准。
原因判断
资料缺口通常不是资料不存在，而是整理口径不统一。先确认资料归属哪条服务线路，再确认该线路要求的字段是否齐全，避免把所有资料混在一起补。
处理步骤
- 列出缺失字段，标注每项属于哪条线路的需求。
- 指定每项资料的整理责任人，约定提交格式与版本标识。
- 补齐后与已有资料比对，确认无冲突再进入下一环节。
升级路径 补齐后仍无法对齐口径，或资料涉及多个团队且无明确责任人时，升级到阶段确认点，由双方对接人共同确认资料范围和责任分工。
接口不通
所属环节：迁移落地
现象
- 联调时请求能发出，返回结果与预期字段不一致。
- 部分调用成功、部分失败，失败集中在特定参数或时段。
- 更换环境后同一接口表现不同。
原因判断
先区分是约定不一致还是配置问题。字段含义、编码方式、超时与重试规则属于约定；地址、证书、权限属于配置。约定不一致时改配置无效，只会在联调中反复出现同类现象。
处理步骤
- 核对双方接口约定版本，确认字段与编码一致。
- 在单一环境复现，记录请求参数、返回结果与时间点。
- 按约定修正后重新联调，把结论写进阶段记录。
升级路径 同一现象在修正约定后仍可复现，或问题影响阶段确认点判断时，升级并附上复现记录，避免从头复述。
环境差异
所属环节：迁移落地与验收运维
现象
- 测试环境正常，迁移环境出现异常。
- 依赖组件的版本或部署方式与记录不符。
- 配置项在两侧名称相同但取值不同。
原因判断
环境差异多数来自清点不完整。先对比版本、部署方式、依赖组件和配置取值四项，逐项列出差异，再判断哪项差异与现象相关。具体兼容性结论需在适配判断中核对，不在处置环节直接下判断。
处理步骤
- 按四项维度做两侧环境对照表，标注差异项。
- 在差异最小化的环境中复现，确认现象是否消失。
- 把确认后的环境基线写进交付记录，供验收引用。
升级路径 差异项无法在现有条件下对齐，或对齐后影响已确认的交付范围时，升级到阶段变更处理，重新确认范围与顺序。
验收分歧
所属环节：验收运维
现象
- 双方对同一交付物是否达标理解不同。
- 验收口径在阶段推进中发生变化，早期记录未被引用。
- 验收项缺少对应材料，无法判断是否满足。
原因判断
验收分歧多来自确认点记录不完整。先回到阶段确认点，核对当时的交付物和确认口径，再判断分歧是口径变化还是材料缺失。
处理步骤
- 把分歧写成条目：分歧点、双方理解、依据材料。
- 对照阶段确认点记录，确认口径是否发生变化。
- 约定暂定处理方式和再次确认时间，写入记录。
升级路径 分歧涉及交付范围或阶段顺序调整时，升级到阶段变更处理，由双方对接人共同确认后再继续。
常见问答
以下问答围绕问题处置的责任分工、资料补齐和升级时机整理，点击标题展开。
问题处置由谁发起，双方各自负责什么？
问题处置由发现现象的一方发起，通常是项目对接人。提交方负责描述现象、提供复现条件和已尝试的处理步骤；天美国产负责判断问题落在哪条服务线路，给出处理顺序和需要补齐的资料。技术结论需要双方在适配判断中共同确认，不由单方直接下结论。
资料缺口补齐前，能否先推进其他环节？
可以并行推进不依赖该资料的部分，例如环境清点和角色确认。但涉及接口约定、数据结构或验收口径的环节，需要等资料补齐后再继续，否则后续判断会反复推翻。资料缺口属于交付轨道中的阶段变更情形，应按变更处理顺序记录。
接口不通时，先查配置还是先查约定？
先查接口约定是否一致，再查配置。约定包括字段含义、编码方式、超时与重试规则，配置包括地址、证书和权限。约定不一致时改配置无法解决，只会在联调中反复出现同类现象。核对记录应写明两侧各自的约定版本。
什么情况下应该升级，而不是继续排查？
出现三种情况建议升级：同一现象在处理步骤走完后仍可复现；问题影响到阶段确认点的判断；两侧对原因归属存在分歧且无法用记录对齐。升级时带上现象描述、已做步骤和记录，避免从头复述。
验收分歧如何记录，避免下一阶段重复争议？
把分歧写成条目：分歧点、双方理解、依据材料、暂定处理方式和再次确认时间。记录放在阶段确认点附近，与交付物对应。下一阶段引用同一份记录，避免口径在口头沟通中发生变化。