页面速度优化工具：工具支持的对象格式变化时怎样改输入规范
📱 Mozilla/5.0 (compatible; QlyzeBot/1.0; +https://app.qlyze.io/bot)
🔗 /fc8cb02961fd.html
📄
页面速度优化工具：工具支持的对象格式变化时怎样改输入规范
结论先说：当页面速度优化工具支持的对象格式发生变化时，不要直接把旧输入批量改成新格式。先判断旧输入里哪些字段是“工具用来识别测试对象”的，哪些只是“描述性备注”。前者必须按新格式重写，后者可以保留。判断依据是：如果旧输入去掉某个字段后，工具仍然能把结果对应回同一个页面或同一批资源，那这个字段属于备注；如果去掉后结果无法归属，它就必须按新规范重建。
先分清两类格式变化，再决定改不改输入
格式变化通常有两种。第一种是对象标识方式变化，例如原来用页面地址作为唯一识别，现在工具要求用资源清单或分组标识来识别。第二种是字段承载方式变化，例如原来一个字段里塞了多个信息，现在拆成多个独立字段。
这两种变化对应的动作不同：
- 标识方式变化：旧输入必须重写，不能靠脚本做字符串替换，因为替换后可能把不同对象合并成同一个。
- 字段拆分变化：旧输入可以保留原值，但需要新增映射关系，否则工具读到空字段会跳过或报错。
判断属于哪一种，可以拿三条旧输入做一次小范围试跑。如果试跑结果里出现“多个输入对应同一个结果”或“输入被丢弃”，说明标识方式变了；如果只是部分字段为空但结果仍能生成，说明是字段承载方式变了。
条件一：旧输入仍能被工具识别时，只补映射不重写
如果试跑显示旧输入仍能生成独立结果，只是新格式要求的某些字段为空，那么正确动作是补映射，而不是重写全部输入。
具体做法：先列出新格式要求但旧输入没有的字段，再为每个字段确定一个稳定来源。稳定来源可以是旧输入里已有的另一个字段，也可以是外部维护的一份对照关系。补映射后，再跑一次同样的三条输入，确认结果数量与旧输入数量一致。
这一步的结果会直接影响下一步：如果结果数量一致，就可以把补映射规则应用到全量输入；如果结果数量变少，说明补映射过程中发生了对象合并，必须回到标识方式变化那一类处理。
假设例子：某团队原来用页面地址作为输入，工具新格式要求额外提供资源分组标识。他们没有重写地址，而是维护了一份“地址到分组”的对照关系，试跑后结果数量不变，于是只把对照关系补进输入流程。这个例子里，地址是标识字段，分组标识是新增的承载字段。
条件二：旧输入无法被识别时，必须重建标识并保留旧值作备注
如果试跑显示旧输入被丢弃或大量合并，就不能继续沿用旧标识。此时的动作是重建标识：按新格式的要求，为每个测试对象生成一个新的唯一标识，再把旧输入里的原始值放到备注或描述字段里。
重建时要注意顺序：
- 先确认新格式里哪个字段承担唯一识别职责，不要假设它一定是第一个字段。
- 为每个旧对象生成新标识，生成规则要能保证不同对象不会得到相同标识。
- 把旧值写入备注字段，保留可追溯性，但不要让它参与识别。
- 用新旧两套输入各跑一次，比较结果覆盖的对象范围是否一致。
如果两次结果覆盖的对象范围一致，说明重建完成；如果新输入覆盖范围更大或更小，说明生成规则里混入了不该参与识别的字段，需要回退到第二步调整。
例外：格式变化伴随工具侧口径调整时，先停用旧输入
有一种情况不能按上面两类处理：格式变化的同时，工具对结果的统计口径也变了，例如原来按请求次数统计，现在按对象数量统计。这时旧输入即使能跑通，结果也不能直接和旧结果比较。
遇到这种情况，实际动作是先停用旧输入，不要在新旧结果之间做趋势对比。停用后，用同一批对象分别在新格式下跑两次，确认两次结果一致，再把新输入作为后续基线。
判断是否属于这种例外，可以看一个信号：格式变化前后，同一批对象的输入数量没有变，但结果里的计数单位变了。这个信号只说明口径可能变了，不能单独证明旧输入一定不可用；还需要检查工具文档里对该字段的定义是否也变了。如果定义没变，只是字段位置变了，仍然按前两类处理。
改完输入后，用一次对照确认下一步动作
无论走哪条路径，改完输入后都建议做一次小范围对照：选三条旧输入，分别用旧格式和新格式各跑一次，比较三件事——结果数量、结果覆盖的对象、每个结果对应的原始输入。三项都一致，就可以把改动应用到全量输入；有任何一项不一致，就先不要扩大范围，回到对应条件重新判断。
这个对照的作用不是证明工具正确，而是帮你决定改动是否可以继续推进。它不能替代对工具当前功能和支持格式的核对，具体字段定义和识别规则仍需以工具实际说明为准。
