Android使用Picasso加载跳转至S3的短链接图片无法显示求助

问题根因 #

Picasso默认自带的下载器对多层重定向、跨域/跨协议重定向的支持存在缺陷，尤其是跳转至S3这类带签名参数的资源链接时，容易出现请求校验失败、重定向中断问题。

可行解决步骤 #

1. 自定义OkHttp客户端配置重定向规则 #

不要使用默认的OkHttpDownloader，手动创建OkHttp实例，显式开启重定向跟随配置：

// 提前导入OkHttp3和对应版本的Picasso OkHttp3下载器依赖
val okHttpClient = OkHttpClient.Builder()
    .followRedirects(true) // 开启普通重定向跟随
    .followSslRedirects(true) // 开启HTTP/HTTPS互转的重定向跟随
    .retryOnConnectionFailure(true)
    .build()

val picasso = Picasso.Builder(this)
    .downloader(OkHttp3Downloader(okHttpClient)) // 注意使用OkHttp3版本的Downloader
    .build()

picasso.load("https://b.xxxxx.com/wzxuum2")
    .placeholder(R.drawable.qr_temp)
    // 增加错误回调排查具体问题
    .into(qr_img, object : Callback {
        override fun onSuccess() {
            // 加载成功自定义逻辑
        }

        override fun onError(e: Exception?) {
            // 打印错误日志可直接定位问题，e会返回具体错误类型：403/404/重定向超限/证书错误等
            e?.printStackTrace()
        }
    })

2. 版本兼容检查 #

• 确认Picasso版本升级至2.71828及以上，2.5.2及更早的老版本自带的下载器存在已知的重定向处理bug
• 避免混用OkHttp2和OkHttp3的依赖，统一使用OkHttp3版本的下载器

3. S3资源特殊性排查 #

如果上述配置仍无效，可先手动测试短链接的重定向结果：

• 抓包查看短链接返回的3xx响应头中的Location字段是否为有效的S3资源链接
• 确认S3资源的签名是否有效、是否有访问权限限制、是否开启了防盗链校验
• 若S3使用自定义域名且证书存在信任问题，可在调试阶段临时添加信任配置（生产环境需替换为正规受信证书）

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