使用Glide加载指定URL图片时显示错误占位符该如何解决

• 首先开启Glide调试日志定位根因：执行adb命令adb shell setprop log.tag.Glide DEBUG，复现加载操作后查看Logcat中Glide的报错信息，可直接拿到网络错误、解析失败、权限缺失等具体原因。
• 添加加载异常监听手动捕获错误：给Glide请求设置RequestListener，打印异常堆栈，代码示例如下：

Glide.with(context)
  .load("https://via.placeholder.com/600/1e5390")
  .listener(object : RequestListener<Drawable> {
      override fun onLoadFailed(e: GlideException?, model: Any?, target: Target<Drawable>?, isFirstResource: Boolean): Boolean {
          e?.printStackTrace()
          return false
      }
      override fun onResourceReady(resource: Drawable?, model: Any?, target: Target<Drawable>?, dataSource: DataSource?, isFirstResource: Boolean): Boolean {
          return false
      }
  })
  .error(R.drawable.your_error_placeholder)
  .into(imageView)

常见问题对应修复方案 #

• 权限配置问题：确认AndroidManifest中已添加网络权限<uses-permission android:name="android.permission.INTERNET" />，如果加载的是HTTP链接，Android 9及以上系统默认禁止明文流量，可在application节点添加android:usesCleartextTraffic="true"配置，或者将图片链接升级为HTTPS。
• 缓存冲突问题：先临时禁用内存和磁盘缓存测试：

Glide.with(context)
  .load("https://via.placeholder.com/600/1e5390")
  .skipMemoryCache(true)
  .diskCacheStrategy(DiskCacheStrategy.NONE)
  .into(imageView)

如果禁用缓存后加载正常，清理应用本地缓存后恢复正常缓存策略即可。

• 图片解析/适配问题：临时指定加载原图尺寸测试，添加override(Target.SIZE_ORIGINAL)到加载请求中，确认是否为ImageView尺寸和图片尺寸适配异常导致的加载失败。
• 版本兼容问题：如果使用的Glide版本较旧，升级到最新稳定版即可，部分旧版本存在WebP、HEIC等格式图片解析失败的已知bug。

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