Dynamics CRM SDK中过期或无效JWT令牌的可控结构化处理方案咨询

我来分享下我在使用Microsoft.PowerPlatform.Dataverse.Client处理JWT令牌相关错误时的一些实践，你当前通过消息文本匹配"jwt"的方式确实不够可靠——毕竟微软可能修改错误消息，或者遇到非英文环境时完全不生效。下面是更可控、结构化的处理思路：

1. 优先依赖OrganizationServiceFault的机器可读属性，而非文本消息 #

Dataverse返回的OrganizationServiceFault里藏着更精准的错误信息，远比表面的Message靠谱：

• ErrorCode：不同的令牌问题（过期、无效、签名错误等）对应固定的错误码，比如令牌过期常见的0x80048823（十进制是-2147024893），权限不足类的令牌问题可能是-2147024891，你可以在测试环境模拟各种令牌错误，记录对应的错误码。
• ErrorDetails：这是一个键值对集合，里面通常会包含OAuthError这类字段，直接返回OAuth层面的错误描述（比如invalid_token、expired_token）。

2. 封装专门的令牌错误判断工具类 #

把判断逻辑抽成可复用的方法，避免重复代码，也方便后续维护：

private bool IsJwtRelatedError(OrganizationServiceFault fault)
{
    // 提前收集好测试得到的JWT相关错误码
    var jwtErrorCodes = new HashSet<int> { -2147024891, -2147024893 };
    if (jwtErrorCodes.Contains(fault.ErrorCode))
    {
        return true;
    }

    // 检查OAuthError字段，这是最直接的令牌错误标识
    if (fault.ErrorDetails.TryGetValue("OAuthError", out var oAuthError))
    {
        var errorStr = oAuthError.ToString();
        return errorStr.Contains("invalid_token", StringComparison.OrdinalIgnoreCase) ||
               errorStr.Contains("expired_token", StringComparison.OrdinalIgnoreCase) ||
               errorStr.Contains("jwt", StringComparison.OrdinalIgnoreCase);
    }

    // 最后用消息文本做兜底（仅作为备选，尽量少用）
    return fault.Message.IndexOf("token", StringComparison.OrdinalIgnoreCase) >= 0 &&
           (fault.Message.IndexOf("expired", StringComparison.OrdinalIgnoreCase) >= 0 ||
            fault.Message.IndexOf("invalid", StringComparison.OrdinalIgnoreCase) >= 0);
}

3. 结合令牌刷新与重试逻辑 #

如果判断是令牌过期或可刷新的错误，可以直接调用ServiceClient的RefreshAccessTokenAsync方法刷新令牌，然后重试请求，避免直接抛出错误影响业务：

try
{
    await serviceClient.ExecuteAsync(request);
}
catch (FaultException<OrganizationServiceFault> ex)
{
    if (IsJwtRelatedError(ex.Detail))
    {
        logger.LogError(ex, "检测到JWT令牌错误：{Error}", ex.Detail.Message);
        try
        {
            // 尝试刷新令牌
            await serviceClient.RefreshAccessTokenAsync();
            // 重试请求
            await serviceClient.ExecuteAsync(request);
            logger.LogInformation("令牌刷新成功，请求已重试完成");
        }
        catch (Exception refreshEx)
        {
            logger.LogError(refreshEx, "令牌刷新失败，无法重试请求");
            throw; // 或者根据业务需求做降级处理
        }
    }
    else
    {
        logger.LogError(ex, "Dataverse请求失败：{Error}", ex.Detail.Message);
        // 处理其他类型的Dataverse错误，比如业务逻辑错误、实体不存在等
    }
}
catch (Exception ex)
{
    logger.LogError(ex, "发生未预期的请求错误");
    // 处理非FaultException类型的错误，比如网络问题
}

一些额外的注意事项 #

• 错误码需要自己测试收集：不同版本的Dataverse可能有细微差异，建议在测试环境模拟令牌过期、篡改、权限不足等场景，记录对应的ErrorCode和ErrorDetails，更新到你的判断逻辑里。
• 避免依赖本地化文本：如果你的系统需要支持多语言，消息文本会被本地化，完全不会出现"jwt"这类英文关键词，所以一定要优先用错误码和ErrorDetails。
• 合理控制重试次数：如果刷新令牌后仍然失败，不要无限重试，建议设置1-2次的重试上限，避免死循环。

内容来源于stack exchange