为MaterialAlertDialogBuilder应用自定义ThemeOverlay出现样式与触摸区域异常的问题

• 样式退化为AppCompat风格的核心原因：之前自定义Overlay的父类选得不对。ThemeOverlay.MaterialComponents.Dialog是给基础无标题Dialog设计的覆盖层，完全不包含MaterialAlertDialogBuilder需要的全套Material Alert样式参数——比如圆角规则、海拔阴影、按钮样式、列表布局逻辑。当你把这个Overlay挂载到全局的materialAlertDialogTheme属性上时，系统解析对话框样式时找不到AlertDialog专属的属性引用，就会自动回退到原生AppCompat的AlertDialog实现，自然就丢失了Material设计特征。
• 列表项触摸区域不撑满全宽，是刚才样式回退带来的连锁反应：回退到AppCompat实现后，这个版本的对话框列表项默认用wrap_content宽度，没有Material版本里列表项根布局的match_parent适配逻辑，才会出现触摸范围只覆盖文本、拉不满对话框全宽的问题，和你单独修改colorOnSurface的操作没有直接关联。

• 你目前写的Overlay基础继承思路是对的，但有两个关键疏漏才导致了异常：
  1. 父类匹配错误：AlertDialog专属的主题覆盖层父类应该是ThemeOverlay.MaterialComponents.Dialog.Alert，不是不带Alert后缀的基础Dialog覆盖层。
  2. 属性映射断链：Material对话框的文本对比度逻辑，不是直接读取全局的colorOnSurface，而是通过textColorPrimary、textColorSecondary两个attr映射带透明度的色值。你单独修改colorOnSurface既不会真的改变对话框内部的文本颜色引用，还会打断原有的样式属性解析流程。

以下方案完全保留Material对话框的原生交互和样式，仅调整文本对比度，不会出现样式回退问题：

• 方案1：修正全局挂载的Overlay配置
  把自定义Overlay的父类换成AlertDialog专属版本，覆盖文本颜色映射属性，保留原有样式链：

  <style name="ThemeOverlay.App.Dialog.HighContrast" parent="ThemeOverlay.MaterialComponents.Dialog.Alert">
      <!-- 直接覆盖对话框使用的主文本、次要文本颜色为高对比度值，不打断原有样式解析 -->
      <item name="textColorPrimary">@color/appColorOnSurfaceHighContrast</item>
      <item name="textColorSecondary">@color/appColorOnSurfaceHighContrast</item>
  </style>
  

  配置完成后再挂载到全局主题的materialAlertDialogTheme属性上，就不会出现样式回退问题。
• 方案2：局部给Builder传入主题
  如果不想全局修改所有对话框的样式，不需要调整全局主题配置，在初始化MaterialAlertDialogBuilder时直接传入修正后的Overlay主题即可：

  // 示例：传入自定义高对比度主题覆盖层
  MaterialAlertDialogBuilder(context, R.style.ThemeOverlay_App_Dialog_HighContrast)
  

• 方案3：资源级覆盖透明度
  如果你不想修改主题配置，可以直接覆盖Material组件库的中等强调文本透明度资源，从颜色根源把60%透明度替换成无透明度的高对比度色值：

  <!-- 在项目的colors.xml中添加覆盖，完全不影响原有属性链 -->
  <color name="material_on_surface_emphasis_medium">@color/appColorOnSurfaceHighContrast</color>
  

  这个方式的兼容性最好，所有依赖该透明度资源的组件都会自动使用高对比度色值，不会触发任何样式回退逻辑。

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