表单校验提示不显示或错位的常见原因包括：setCustomValidity()需配合reportValidity()触发、原生气泡样式不可控且兼容性差、应改用aria-invalid+自定义span实现可控提示，并注意blur/submit时机校验及服务端错误同步。
表单校验提示不显示或错位的常见原因
浏览器原生 setCustomValidity() 触发后，提示气泡只在调用 reportValidity() 或用户提交时才浮现，且默认位置不可控。很多开发者误以为调用 setCustomValidity("错误") 就会立刻弹出提示，结果页面毫无反应。
- 必须配合
reportValidity()才能强制触发（仅对整个表单）或checkValidity()+ 手动 DOM 操作 - 单个字段调用
reportValidity()无效，它只作用于<form>元素 - Chrome 和 Safari 的气泡样式无法用 CSS 定制，Firefox 更不显示原生气泡
用 aria-invalid + 自定义 <span> 替代原生气泡
这是目前最可控、无障碍友好、且兼容所有现代浏览器的做法：放弃原生气泡，接管提示逻辑。
- 给每个
<input>添加aria-invalid="false"初始状态，并配一个紧邻的<span class="error"></span> - 校验失败时：设置
input.setAttribute('aria-invalid', 'true')，同时填入span.textContent = "手机号格式不正确" - 校验通过时：设
aria-invalid="false"，清空span文本 - 可加简单 CSS 控制
.error { color: #d32f2f; font-size: 0.875rem; margin-top: 4px; display: block; }
示例片段：
<label>邮箱</label> <input type="email" id="email" aria-invalid="false"> <span class="error" role="alert"></span>
constraint validation API 的关键调用时机
校验不是越早越好，也不是每次输入都该触发。时机错了，体验反而更差。
立即学习“前端免费学习笔记（深入）”；
- 不要在
input事件里频繁调用checkValidity()：会导致中文输入法未完成时就报错（如输“zh@”就提示） - 推荐在
blur（失焦）和submit时校验：用户明确结束输入或意图提交 - 若需实时反馈，改用
compositionend事件过滤输入法场景，再结合防抖（如 300ms） - 对密码确认类字段，应在另一个字段
blur后，主动调用其checkValidity()并更新 UI
服务端校验失败后如何同步前端提示
前端校验只是第一道防线，后端返回 400 错误时，必须把字段级错误映射回对应 DOM 节点。
- 后端响应体建议统一含
errors字段，形如{"email": ["已被注册"], "captcha": ["验证码错误"]} - 前端收到后，遍历对象 key，找到对应
document.getElementById(key)或querySelector('[name="' + key + '"]') - 对每个字段：设
aria-invalid="true"，填充对应<span class="error">，并聚焦首个出错字段（el.focus()） - 注意清除之前手动设置的错误状态，避免残留提示
真正难的不是写校验逻辑，是让提示在对的时间、以对的方式、出现在对的位置——尤其是混合了输入法、焦点管理、服务端联动之后，DOM 状态很容易不同步。
