Azure AD B2C账户报错：自定义错误页还是调整自定义策略？

1. 应用层自定义错误页方案 #

之前配置未生效的核心原因有两个：

• 仅在开发环境分支注册了异常处理中间件，生产环境无对应配置
• Azure AD B2C认证过程抛出的远程认证异常，执行优先级高于通用异常处理中间件，默认不会被UseExceptionHandler拦截

正确配置步骤：

• 移除异常处理配置的环境判断，全局注册异常处理与状态码页中间件：

// 全局生效，不要放在IsDevelopment判断块内
app.UseExceptionHandler("/CustomError"); // 替换为你的自定义错误页路由
app.UseStatusCodePagesWithReExecute("/CustomError", "?statusCode={0}");

• 在Azure AD B2C的OpenID Connect认证配置中，追加远程失败事件拦截，直接接管B2C返回的认证错误：

builder.Services.AddAuthentication(AzureADB2CDefaults.AuthenticationScheme)
    .AddAzureADB2C(options =>
    {
        // 保留原有的B2C实例、租户、客户端ID等配置
    })
    .AddOpenIdConnect(AzureADB2CDefaults.OpenIdScheme, options =>
    {
        options.Events = new OpenIdConnectEvents
        {
            OnRemoteFailure = context =>
            {
                var errorMsg = Uri.EscapeDataString(context.Failure?.Message ?? "认证失败");
                context.Response.Redirect($"/CustomError?msg={errorMsg}");
                context.HandleResponse();
                return Task.CompletedTask;
            }
        };
    });

• 如果要覆盖ASP.NET Core内置的AzureADB2C UI默认错误页，不需要修改类库内置文件，直接在项目的Pages/Shared路径下新建同名Error.cshtml即可，Razor视图引擎会优先加载项目内的自定义视图。

2. 自定义策略调整方案 #

之前配置触发API格式错误的核心原因：将RaiseErrorIfClaimsPrincipalDoesNotExist设为false后，没有补全用户不存在场景的分支逻辑，后续编排步骤直接读取空的objectId执行写用户、发令牌操作，触发协议校验错误。

正确配置步骤：

• 保留之前修改的RaiseErrorIfClaimsPrincipalDoesNotExist="false"配置，无需回滚
• 在AAD-FindB2CUserWithAADOid技术配置文件执行后，新增一个声明转换步骤，判断用户是否存在：

<ClaimsTransformation Id="ValidateUserExistence" TransformationMethod="DoesClaimExist">
  <InputClaims>
    <InputClaim ClaimTypeReferenceId="objectId" TransformationClaimType="inputClaim" />
  </InputClaims>
  <OutputClaims>
    <OutputClaim ClaimTypeReferenceId="isUserExisted" TransformationClaimType="outputClaim" />
  </OutputClaims>
</ClaimsTransformation>

• 在用户旅程编排中新增分支判断：如果isUserExisted为false，直接跳转至预先配置的自断言错误页，展示访问拒绝提示，终止后续令牌发放流程；如果isUserExisted为true，再走原有的账户关联、SendClaims逻辑。
• 该方案的优势是直接在B2C认证层完成错误拦截，所有接入该租户的应用会自动复用统一的错误页样式，不需要每个应用单独改造。

选型建议 #

• 若为单应用接入、需要快速上线，优先选应用层自定义错误页方案，改造成本最低
• 若为多应用共用B2C租户、需要统一全场景认证体验，优先选自定义策略调整方案，长期维护成本更低

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