You need to enable JavaScript to run this app. Kotlin使用OkHttpClient请求多级路径URL失败的原因及解决方法
优惠活动
大模型
产品
解决方案
定价
更多

Kotlin使用OkHttpClient请求多级路径URL失败的原因及解决方法

问题根本原因
  • 完全不存在“URL嵌套层级过高导致请求失败”的问题,所有测试现象的共性触发点是请求使用了明文HTTP协议,和路径长度、目录层级、文件大小均无关联。
  • 具体触发链路:
    1. 当代码运行在Android 9.0(API 28及以上)系统环境时,系统默认全局阻断所有未加密的明文HTTP流量,这类请求会在系统网络层直接抛出异常,根本不会传递到OkHttp的请求处理逻辑,最终直接触发onFailure回调输出"Failed"。
    2. 之前形成“短路径正常、长路径失败”的错觉,本质是测试变量没有控制一致:测试通过的短路径URL恰好使用了HTTPS加密协议,测试失败的长路径、两级目录URL全部使用了明文HTTP协议,属于测试变量混淆导致的误判。
    3. 额外潜在问题:你访问的Riot相关服务端节点目前已经对所有HTTP请求配置了永久重定向到对应HTTPS地址的规则,如果没有配置OkHttp的自动跟随重定向能力,就算临时放开明文权限,也会因为跳转链不匹配导致请求失败。
对应修复方案
  • 优先级最高的修复:直接将所有测试URL的协议从http://替换为https://,完全适配系统的明文流量拦截规则,无需额外修改配置即可正常请求:
    替换后之前失败的两个地址分别为:
    • https://ddragon.leagueoflegends.com/cdn/11.2.1/data/en_GB/champion.json
    • https://static.developer.riotgames.com/docs/lol/maps.json
      该方案和你测试通过的https://ddragon.leagueoflegends.com/api/versions.json使用的协议规则完全一致。
  • 如果业务场景必须临时发起HTTP明文请求,禁止全局放开所有域名的明文权限,按需做定向配置:
    1. 在安卓项目的res/xml目录下新建网络安全配置文件network_security_config.xml,仅对需要访问的目标域名开放明文权限:
      <?xml version="1.0" encoding="utf-8"?>
      <network-security-config>
          <domain-config cleartextTrafficPermitted="true">
              <domain includeSubdomains="true">ddragon.leagueoflegends.com</domain>
              <domain includeSubdomains="true">static.developer.riotgames.com</domain>
          </domain-config>
      </network-security-config>
      
    2. 在应用的AndroidManifest.xml的application标签下引用该配置:android:networkSecurityConfig="@xml/network_security_config"
  • 优化OkHttpClient的基础配置,显式开启自动跟随重定向能力,适配服务端的HTTPS跳转规则:
    val client = OkHttpClient.Builder()
        .followRedirects(true) // 跟随301/302/308等HTTP跳转
        .followSslRedirects(true) // 适配HTTPS协议跳转
        .build()
    
  • 排障提示:之前的onFailure回调仅输出了固定的"Failed"字符串,没有打印捕获的异常堆栈,导致无法定位真实错误。将回调修改为println("Failed: ${e.message}")后,会直接看到明文流量拦截的对应报错,不会再出现误判为URL路径问题的情况。

内容的提问来源于stack exchange,提问作者dk9876

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.07 17:24:10