前端HTML质量检测失效的根本原因是检测时机错误，必须在DOMContentLoaded瞬间fetch真实服务端HTML并解析比对结构树哈希值，而非依赖浏览器修正后的outerHTML。
前端行为驱动测试中，HTML代码质量异常无法自动派单——根本原因不是缺算法，而是检测点没落在真实 DOM 变化发生的时刻。
DOMContentLoaded 后 fetch 原始 HTML 才能暴露服务端漏渲染
很多团队在行为驱动测试里埋了“HTML 结构校验”，但用 document.documentElement.outerHTML 对比快照，结果永远显示“一致”。这是因为 outerHTML 返回的是浏览器修正后的 DOM，<div><p>文本</p></div> 这种非法嵌套会被自动补全为 <div><p>文本</p></div>，原始错误被掩盖。
- 正确做法：在
DOMContentLoaded触发瞬间发起fetch(location.href, { cache: 'no-store' })，拿到服务端真实响应体 - 必须加
{ cache: 'no-store' }，否则可能命中强缓存，返回旧 HTML - 服务端需支持 CORS，否则 fetch 被拦截；若受限，退而求其次，从
document.querySelector('script[type="application/json"]')提取可预测的原始数据锚点作校验 - 对比逻辑不是字符串相等，而是用
new DOMParser().parseFromString()解析后比对关键节点（如main、form）的结构树哈希值
MutationObserver 必须过滤非主应用变更
行为驱动测试关注的是“用户操作引发的 HTML 变化是否符合预期”，但第三方 SDK、广告脚本、埋点代码常在 load 后注入 DOM，污染变更来源。直接监听所有 childList 会捕获大量噪音。
- 监听时设
{ subtree: true, childList: true }，但禁用characterData（性能开销大） - 在回调中通过
mutation.target.ownerDocument.defaultView === window判断是否来自主应用上下文 - 记录变更前后的
outerHTML并计算 SHA-256，只上报 hash 差异且非白名单脚本触发的变更 - 观察器应在
load后 5s 自动disconnect，避免长期驻留影响页面性能
微前端场景下 v-html 和 dangerouslySetInnerHTML 必须单独过筛
行为驱动测试跑在完整页面上，但 HTML 质量异常可能藏在 Vue/React 组件的内联 HTML 中。htmlhint 扫不到 v-html 绑定的字符串，eslint-plugin-html 又不检查属性拼写错误（比如把 class 写成 clss）。
立即学习“前端免费学习笔记（深入）”；
- 对 Vue 项目，用
eslint-plugin-vue的vue/no-v-html规则禁止无 sanitization 的v-html，或强制走DOMPurify.sanitize() - 对 React 项目，在 CI 阶段用正则提取所有
dangerouslySetInnerHTML: { __html:.*?}字段，喂给htmlparser2做片段级校验 - 所有动态插入的 HTML 字符串（包括
innerHTML、insertAdjacentHTML）必须在单元测试中覆盖其输入边界，例如空字符串、含<script></script>标签的恶意内容
真正难的不是写检测逻辑，而是让每个检测点和真实用户行为对齐：点击按钮后 DOM 是否按预期更新？表单提交后是否生成合法结构？这些时刻的 HTML 必须是未经浏览器修正、未被第三方篡改、未被框架抽象掉的真实产物。漏掉任一环节，派单系统就只是在给幻影告警。
