Glide+AndroidSVG加载SVG失败，疑Glide配置未识别相关组件

问题描述 #

使用Glide 4.10.0版本结合AndroidSVG实现ImageView加载SVG资源，已参照官方v4.10.0的SVG示例代码，在同包下复制了SvgDecoder、SvgDrawableTranscoder、SvgModule类，但调用Glide加载指定SVG资源（测试链接：https://dev.w3.org/SVG/tools/svgweb/samples/svg-files/410.svg）时触发onLoadFailed回调，仅提示“无法加载资源”无具体原因，怀疑Glide未正确识别自定义组件。

加载代码如下：

GlideUrl glideUrl = .....

Glide.with(thumbnailImageView.getContext())
    .as(PictureDrawable.class)
    .load(glideUrl)
    .placeholder(R.color.file_placeholder)
    .listener(new RequestListener<PictureDrawable>() {
        @Override
        public boolean onLoadFailed(@Nullable GlideException e, Object model,
                                    Target<PictureDrawable> target, boolean isFirstResource) {
            DataWorkflowTasks.log("thumbnail load failed!" + e.getMessage());

            ImageView view = ((ImageViewTarget<?>) target).getView();
            view.setLayerType(ImageView.LAYER_TYPE_NONE, null);
            
            return false;
        }

        @Override
        public boolean onResourceReady(PictureDrawable resource, Object model,
                                       Target<PictureDrawable> target, DataSource dataSource,
                                       boolean isFirstResource) {
            ImageView view = ((ImageViewTarget<?>) target).getView();
            view.setLayerType(ImageView.LAYER_TYPE_SOFTWARE, null);

            //on load success
            return false;
        }
    })
    .into(thumbnailImageView);

排查与解决步骤 #

1. 验证Glide模块的注册合法性 #

Glide v4强制要求通过@GlideModule注解+继承AppGlideModule来注册自定义组件，检查你的SvgModule：

• 必须添加com.bumptech.glide.annotation.GlideModule注解（不是旧版注解）
• 必须继承AppGlideModule，而非已废弃的GlideModule
• 确保在build.gradle中添加注解处理器依赖：

  dependencies {
      annotationProcessor 'com.github.bumptech.glide:compiler:4.10.0'
      implementation 'com.github.bumptech.glide:glide:4.10.0'
      implementation 'com.caverock:androidsvg-aar:1.4' // 适配Glide 4.10.0的AndroidSVG版本
  }
  

2. 打印完整异常堆栈定位根因 #

当前仅打印e.getMessage()无法获取有效信息，修改onLoadFailed方法，打印完整异常链：

@Override
public boolean onLoadFailed(@Nullable GlideException e, Object model,
                            Target<PictureDrawable> target, boolean isFirstResource) {
    if (e != null) {
        DataWorkflowTasks.log("Load failure detail:");
        // 遍历所有根因
        for (Throwable cause : e.getRootCauses()) {
            DataWorkflowTasks.log("- " + cause.getMessage());
            cause.printStackTrace();
        }
    }
    ImageView view = ((ImageViewTarget<?>) target).getView();
    view.setLayerType(ImageView.LAYER_TYPE_NONE, null);
    return false;
}

通过根因可直接定位是组件未注册、SVG解析失败、网络问题还是权限缺失。

3. 确认自定义解码器被调用 #

在SvgDecoder的decode方法中添加日志，验证Glide是否触发了解码逻辑：

@Override
public SVG decode(DataSource source, int width, int height, Options options) throws IOException {
    DataWorkflowTasks.log("SvgDecoder triggered");
    InputStream inputStream = source.getInputStream();
    try {
        return SVG.getFromInputStream(inputStream);
    } finally {
        inputStream.close();
    }
}

如果日志未打印，说明Glide未识别到该解码器，回到步骤1检查模块注册。

4. 排除网络与资源本身问题 #

• 确认应用已申请INTERNET权限（AndroidManifest.xml中添加<uses-permission android:name="android.permission.INTERNET"/>）
• 先测试加载本地SVG资源（如res/raw下的文件），用Glide.with(...).load(R.raw.local_svg)验证逻辑是否正常，排除远程资源问题
• 确认GlideUrl配置正确，若为HTTPS请求，检查证书信任配置

5. 验证SVG兼容性 #

部分SVG可能包含AndroidSVG不支持的特性，可直接用AndroidSVG解析测试链接的SVG：

new Thread(() -> {
    try {
        URL url = new URL("https://dev.w3.org/SVG/tools/svgweb/samples/svg-files/410.svg");
        SVG svg = SVG.getFromInputStream(url.openStream());
        DataWorkflowTasks.log("SVG parse success: " + svg.getDocumentSize());
    } catch (Exception e) {
        e.printStackTrace();
    }
}).start();

如果解析失败，说明该SVG存在兼容性问题，需调整SVG内容或升级AndroidSVG版本。

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