.NET Framework 4.5调用Maximo Rest API提示LTPA token无效问题求解

问题根因 #

• .NET Framework 4.5 内置的CookieContainer存在两处已知的兼容缺陷，而.NET Core 2.1 已经修复了这些问题，所以相同逻辑在Core环境可以正常运行：
  1. Cookie路径匹配逻辑错误：Maximo返回的LTPA Token默认路径为/，但.NET 4.5 下会对请求子路径做严格的冗余校验，导致实际发起GET请求时没有携带对应Cookie，服务端收不到有效Token就返回报错。
  2. 带端口域名的Cookie存储逻辑异常：如果你的Maximo服务地址携带端口号，.NET 4.5 的CookieContainer会错误的把端口号加入域名校验规则，导致Cookie匹配失败。
• 代码写法放大了缺陷影响：你每次调用HttpGetRequest都会重新实例化HttpClientHandler和HttpClient，新的Handler实例读取Cookie时会再次触发上述匹配逻辑缺陷，进一步提升了报错概率。
• Postman重试生效的原因是首次认证后的Cookie已经存储，第二次请求会跳过校验逻辑直接携带Cookie，所以可以请求成功。

解决方案 #

按照以下步骤修改即可彻底解决问题：

1. 全局复用HttpClient和Handler实例
   不要每次请求都新建HttpClient和HttpClientHandler，将二者改为类的私有字段，仅在类初始化或认证时实例化一次，同时避免.NET 4.5 下频繁新建HttpClient导致的端口耗尽问题。

2. 认证后手动修正LTPA Cookie属性
   在Authenticate方法拿到认证响应后，手动修正Cookie的路径和域名属性，绕过系统的匹配缺陷：

// 这段代码放在Authenticate方法拿到HttpResponseMessage之后执行
Uri baseUri = new Uri(this.ServerURL);
var allCookies = this.cookieContainer.GetCookies(baseUri);
foreach (Cookie cookie in allCookies)
{
    // 匹配LTPA相关Cookie
    if (cookie.Name.StartsWith("LtpaToken"))
    {
        // 强制设置为根路径
        cookie.Path = "/";
        // 强制设置为不带端口的主机地址
        cookie.Domain = baseUri.Host;
    }
}

3. 禁用Expect:100-continue请求头
   .NET 4.5 默认会给POST请求加上Expect:100-continue头，部分WebSphere版本处理这个头时会导致会话异常，在程序启动时全局添加以下配置即可：

System.Net.ServicePointManager.Expect100Continue = false;

4. 添加兜底重试逻辑
   如果仍有偶现的LTPA无效报错，可以在GET请求时增加1次重试：遇到报错时清空当前CookieContainer，重新调用Authenticate认证后再次发起请求，逻辑和Postman重试生效逻辑一致。

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