Azure B2C JIT用户迁移自定义策略多场景故障排查咨询

场景1：B2C存量用户登录报标识声明缺失 #

你遇到的具体报错是“作为identifier claim type的signInNames.emailAddress，未在claim principal的claim集合中找到”，本质是编排顺序错乱导致的声明流截断：

• 原有本地账户入门包的流程中，本地用户校验技术配置执行成功后，会自动将用户的signInNames.emailAddress写入最终声明集，作为后续令牌签发的必需标识
• 目前大概率是将REST技术配置直接插入到了本地用户校验的流程节点前，打断了原有声明的传递链路，导致该声明根本没有机会写入最终的声明集合，触发令牌生成环节的报错
• App Insights排查重点：搜索ClaimNotFound日志，定位signInNames.emailAddress从声明集合中消失的具体步骤，确认编排顺序是否颠倒

场景2：外部IDP存在、B2C不存在的用户报“未找到账户” #

你遇到的具体报错是“未找到具有指定凭据的用户”，核心原因是本地用户校验步骤没有配置异常路由：

• 原有本地登录的技术配置在查不到B2C用户时，会直接抛出用户不存在的错误，终止整个流程，根本没有触发后续的REST外部IDP校验逻辑
• JIT迁移的核心逻辑是，针对“本地用户不存在”的场景，通过声明转换将其标记为可路由的流程分支，而非直接抛错终止流程
• App Insights排查重点：搜索UserNotFound日志，确认报错的技术配置是否为本地用户查询节点——如果是，就说明缺少对应的分支路由配置

场景3：双系统都不存在的用户报AADB2C90075 #

你遇到的具体报错是“步骤'1'中指定的claim exchange 'REST-UserMigration-LocalAccount-SignIn'返回HTTP错误响应，状态码'BadRequest'”，核心原因是REST技术配置没有配置自定义错误处理：

• B2C默认会将REST接口返回的非200响应直接以原始错误的形式抛出，当前接口在用户不存在时返回400，刚好触发默认的BadRequest报错提示
• 没有对400响应做自定义错误映射，导致用户看到的是后端技术报错，而非预设的“请创建账号”的友好提示
• App Insights排查重点：搜索RestApiCallFailed日志，确认REST调用的实际返回状态、错误头信息，排除请求参数传递错误的情况

你当前的REST接口逻辑非常简单（200=外部IDP凭据校验通过，仅返回无业务价值的令牌；400=外部IDP无对应用户），完全不需要照搬通用示例里的全量用户属性输出逻辑，直接按二元判断调整即可：

1. 简化REST技术配置的声明映射
   删掉原有配置里的冗余OutputClaims（needToMigrate/email/newPassword等依赖API返回字段的配置），仅保留：
   • 输入声明：原有signInName（映射为外部接口的username）、password（映射为外部接口的密码字段）
   • 输出声明：不需要从200响应里提取任何字段，只要接口返回200，就代表外部校验通过
   • 错误处理：在技术配置中添加<ErrorHandlers>节点，捕获400状态码，映射为自定义用户提示“我们未找到匹配的账号，请先创建账号”
2. 调整用户旅程的编排分支逻辑
   按照“先查B2C存量用户→存在则直接登录→不存在则校验外部IDP→校验通过则自动创建B2C用户→校验失败则提示创建账号”的顺序配置编排步骤：
   • 步骤1：自断言页面采集用户输入的账号、密码
   • 步骤2：调用B2C本地用户查询接口
     • 若查询到对应用户：设置本地用户存在标记，直接跳转至登录成功的令牌签发步骤
     • 若未查询到对应用户：不抛出错误，直接路由至REST外部校验步骤
   • 步骤3：调用REST接口校验外部IDP的用户凭据
     • 若接口返回200：路由至B2C用户自动创建步骤
     • 若接口返回400：抛出自定义的“请创建账号”提示，终止流程
   • 步骤4：将用户输入的账号、密码写入B2C目录完成用户创建，直接签发本次登录的令牌，完成JIT迁移

不用逐行翻日志，直接搜这几个固定关键字快速定位问题：

• 搜UserJourneyRecords：查看每个编排步骤的实际执行顺序，确认是否存在步骤颠倒、分支路由错误
• 搜ClaimResolving：跟踪核心声明（signInName/password/signInNames.emailAddress）在每个步骤的进出情况，定位声明丢失的节点
• 搜TechnicalProfileExecutionStatus：查看每个技术配置的执行结果、返回状态，定位是哪个节点抛出的原始错误

内容的提问来源于stack exchange，提问作者Pete Helgren