AlertDialog自定义布局内ImageView无法设置图片问题求助

核心原因 #

设置不生效基本为以下三类原因导致：

• AlertDialog默认窗口属性挤压自定义布局：原生AlertDialog默认会给自定义View加固定内边距，且限制最大宽高，wrap_content的布局很容易被挤压导致图片不可见
• ImageView的scaleType和尺寸配置问题：未明确设置ImageView尺寸和缩放规则，大尺寸图片加载后被压缩至不可见，或和默认src叠层导致误以为没替换成功
• 资源引用异常：引用的drawable资源本身存在缺失、适配版本不对或者全透明的问题，看起来和没设置效果一致

修复代码 #

Java逻辑修改 #

public void displayImage(String imgURL){
    // 优先使用androidx兼容包的AlertDialog，避免不同系统版本的兼容性问题
    androidx.appcompat.app.AlertDialog.Builder alertViewPicture = new androidx.appcompat.app.AlertDialog.Builder(SearchActivity.this);
    LayoutInflater factory = LayoutInflater.from(SearchActivity.this);
    final View view = factory.inflate(R.layout.dialog_image, null);
    final ImageView dialogImageView = view.findViewById(R.id.imageViewTest);
    // 明确设置缩放规则，保证图片正常显示
    dialogImageView.setScaleType(ImageView.ScaleType.CENTER_INSIDE);
    // 替换资源
    dialogImageView.setImageResource(R.drawable.bg_afternoon);

    alertViewPicture.setView(view);
    alertViewPicture.setTitle("Alert Dialog Title");
    alertViewPicture.setNeutralButton("OK", new DialogInterface.OnClickListener() {
        @Override
        public void onClick(DialogInterface dlg, int sumthin) {
        }
    });
    
    // 先创建再显示，方便调整窗口参数
    AlertDialog dialog = alertViewPicture.create();
    dialog.show();
    // 调整窗口属性，移除默认边距限制
    Window window = dialog.getWindow();
    if (window != null) {
        WindowManager.LayoutParams params = window.getAttributes();
        params.width = ViewGroup.LayoutParams.MATCH_PARENT;
        params.height = ViewGroup.LayoutParams.WRAP_CONTENT;
        window.setAttributes(params);
        window.getDecorView().setPadding(0, 0, 0, 0);
    }
}

布局XML修改 #

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:padding="16dp">

    <ImageView
        android:id="@+id/imageViewTest"
        android:layout_width="match_parent"
        android:layout_height="300dp"
        android:scaleType="centerInside"
        android:layout_gravity="center"
        android:src="@drawable/ic_road_blue"/>

</LinearLayout>

验证步骤 #

如果修改后还是不生效，按以下顺序排查：

1. 给ImageView设置红色背景，运行后看对话框内有没有红色区域，有则是图片资源问题，没有则是布局被挤压问题
2. 打印日志确认dialogImageView不为空，R.drawable.bg_afternoon是有效可加载的资源
3. 用Glide加载时添加error和placeholder占位图，确认是加载成功还是加载失败走了默认逻辑

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