Android AlertDialog出现多余顶部内边距问题排查求助

问题原因 #

你自定义Dialog样式时直接设置了android:background属性，该属性会作用于AlertDialog的整个根布局，而原生Theme.Material.Dialog默认预留了顶部标题图标占位区域，即使你没有配置对话框图标，该区域的高度仍会保留，背景被你设置的colorGreyMedium填充后就呈现为多余的顶部内边距。部分高版本系统的AlertDialog还会默认给标题区域添加额外顶部padding，也会导致该问题。

解决方案 #

方案1：修改自定义样式（推荐） #

不要给Dialog全局设置android:background，替换为窗口背景属性，同时关闭图标占位即可：

<style name="MyDialogStyle" parent="@android:style/Theme.Material.Dialog">
    <item name="android:textColor">@color/colorBlue</item>
    <item name="android:textColorPrimary">@color/colorBlack</item>
    <!-- 替换全局background为windowBackground，仅作用于窗口背景 -->
    <item name="android:windowBackground">@color/colorGreyMedium</item>
    <item name="android:textSize">@dimen/dim_text_size</item>
    <!-- 取消顶部图标占位，消除预留高度 -->
    <item name="android:icon">@null</item>
    <!-- 可选：若仍有多余padding，直接清空标题区默认内边距 -->
    <item name="android:dialogTitlePadding">0dp</item>
</style>

修改后原来的Dialog创建代码无需改动，直接运行即可消除多余顶部边距。

方案2：代码动态调整边距 #

如果不想修改现有样式，可以在Dialog显示后手动调整布局边距：

AlertDialog dialog = builder.create();
dialog.show();
Window window = dialog.getWindow();
if (window != null) {
    // 调整标题区顶部padding
    View titleView = window.findViewById(android.R.id.title);
    if (titleView != null) {
        titleView.setPadding(titleView.getPaddingLeft(), 0, 
                titleView.getPaddingRight(), titleView.getPaddingBottom());
    }
    // 可选：调整内容区顶部padding
    View contentView = window.findViewById(android.R.id.content);
    if (contentView != null) {
        contentView.setPadding(contentView.getPaddingLeft(), 0,
                contentView.getPaddingRight(), contentView.getPaddingBottom());
    }
}

方案3：使用MaterialAlertDialogBuilder #

如果项目引入了Material Components库，直接替换Dialog构建类即可避免该原生问题：

1. 样式父类改为<style name="MyDialogStyle" parent="@style/Theme.MaterialComponents.Dialog.Alert">
2. 构建代码替换为MaterialAlertDialogBuilder builder = new MaterialAlertDialogBuilder(context, R.style.MyDialogStyle)
   其余配置逻辑保持不变，默认不会生成顶部图标占位区域。

内容的提问来源于stack exchange，提问作者F.M.