
本文介绍如何通过升级自断言页面(selfasserted)的页面布局版本,解决 azure ad b2c 自定义策略中用户使用浏览器自动填充账号密码后,表单验证错误消息未自动清除的问题。
本文介绍如何通过升级自断言页面(selfasserted)的页面布局版本,解决 azure ad b2c 自定义策略中用户使用浏览器自动填充账号密码后,表单验证错误消息未自动清除的问题。
在 Azure AD B2C 自定义策略(Custom Policies)中,当用户访问登录页(如 SelfAsserted-LocalAccountSignin-Email 技术配置文件所对应的页面)时,若直接点击“登录”而未输入凭据,系统会显示红色验证错误(如“请输入用户名”“请输入密码”)。该错误在用户手动输入后可正常消失;但当用户使用浏览器(Chrome / Edge / Safari)的密码管理器自动填充凭据时,错误提示常持续显示,尽管字段已填满且登录功能仍可成功执行——这严重影响用户体验与界面一致性。
该问题的根本原因在于:旧版页面布局(如 2.1.14 或更早)未正确监听 input、change 及 autocomplete 事件,导致前端验证逻辑无法感知自动填充触发的值变更。而新版页面布局(2.1.25+ 起,尤其是 2.1.30+)已内置对 autocomplete="username"/autocomplete="current-password" 的兼容支持,并通过 MutationObserver 或 input 事件代理自动重置验证状态。
✅ 解决方案:升级 selfasserted 页面的 DataUri 版本
在自定义策略文件(通常是 TrustFrameworkBase.xml)中定位 <contentdefinitions></contentdefinitions> 节点,找到对应登录页的 <contentdefinition></contentdefinition> 元素(ID 通常为 api.selfasserted 或 api.localaccountsignin),修改其 <datauri></datauri> 值:
<!-- 修改前(旧版,可能不支持自动填充事件) -->
<ContentDefinition Id="api.selfasserted">
<LoadUri>~/tenant/templates/AzureBlue/selfasserted.html</LoadUri>
<RecoveryUri>~/common/default_page_error.html</RecoveryUri>
<DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.14</DataUri>
<Metadata>
<Item Key="DisplayName">Collect information from user page</Item>
</Metadata>
</ContentDefinition><!-- 修改后(推荐使用 2.1.30 或更高稳定版本) -->
<ContentDefinition Id="api.selfasserted">
<LoadUri>~/tenant/templates/AzureBlue/selfasserted.html</LoadUri>
<RecoveryUri>~/common/default_page_error.html</RecoveryUri>
<DataUri>urn:com:microsoft:aad:b2c:elements:contract:selfasserted:2.1.30</DataUri>
<Metadata>
<Item Key="DisplayName">Collect information from user page</Item>
</Metadata>
</ContentDefinition>? 注意事项:
- ✅ 必须同时更新所有引用
api.selfasserted的技术配置文件(如登录、注册、密码重置等)所依赖的 ContentDefinition; - ✅ 版本号需严格匹配 官方文档支持的版本列表,不支持任意数字;
- ⚠️ 升级后请务必在真实浏览器(含无痕模式)中完整测试自动填充流程,确认错误提示消失且表单提交逻辑不受影响;
- ⚠️ 若使用了自定义 HTML 模板,请确保其结构兼容新版 contract schema(例如:
<div id="api"></div>容器必须存在,且 input 字段 class/id 不得破坏 B2C 内置 JS 绑定); - ? 如遇样式异常,可同步检查是否需更新
unifiedssp、multifactor等其他页面的 DataUri 版本以保持体验一致。
? 小贴士:
微软持续通过新页面版本修复此类前端交互缺陷。建议将 DataUri 版本纳入 CI/CD 部署检查项,并定期查阅 Azure AD B2C 页面布局更新日志 进行版本迭代。
完成更新并上传策略后,错误消息将在浏览器自动填充完成瞬间自动清除,实现与标准策略一致的流畅体验。

















