Azure API Management从context提取User Email出现空引用报错求助

你遇到的空引用报错本质是 context.User 对象为null，直接访问其Email属性触发了异常。context.User 仅在当前请求已关联APIM平台内注册的用户实体时才会返回有效对象，以下是常见触发场景及对应解决方案：

• 场景1：请求为匿名请求，或携带的订阅密钥未绑定APIM用户
  解决方案：如果你的接口允许匿名访问，先对context.User做判空处理，避免异常抛出，修改set-header的表达式为：

  <set-header name="customer-email" exists-action="override">
      <value>@(context.User?.Email ?? string.Empty)</value>
  </set-header>
  

• 场景2：未配置身份验证策略，未将请求身份关联到APIM用户
  解决方案：如果接口要求必须登录才能访问，先在inbound策略中增加身份校验逻辑，拦截未携带有效身份的请求，再执行header赋值：

  <inbound>
      <base />
      <!-- 增加身份校验，示例为JWT校验，可替换为你使用的认证方式 -->
      <validate-jwt header-name="Authorization" failed-validation-httpcode="401" failed-validation-error-message="无效令牌">
          <openid-config url="你的OIDC配置地址" />
          <required-claims>
              <claim name="sub" match="any" />
          </required-claims>
      </validate-jwt>
      <!-- 增加User非空判断 -->
      <choose>
          <when condition="@(context.User == null)">
              <return-response>
                  <set-status code="401" reason="Unauthorized" />
                  <set-body>当前请求未关联有效用户</set-body>
              </return-response>
          </when>
      </choose>
      <set-backend-service id="apim-generated-policy" backend-id="azure-func-staging" />
      <set-header name="customer-email" exists-action="override">
          <value>@(context.User.Email)</value>
      </set-header>
  </inbound>
  

• 场景3：使用服务主体/外部身份源认证，用户未同步到APIM用户列表
  如果你使用AAD等外部身份源认证，没有将用户同步到APIM的用户管理列表中，context.User永远为空，此时需要直接从JWT令牌的声明中提取邮箱，修改表达式为：

  @(context.Request.Headers.GetValueOrDefault("Authorization", "").AsJwt()?.Claims.GetValueOrDefault("email", "") ?? string.Empty)
  

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