Android中Theme.AppCompat.Light.DarkActionBar下PopupMenu背景自定义失效

我明白你在自定义PopupMenu背景时遇到的头疼问题——用AppCompat主题时常规方法经常不生效，我来给你几个靠谱的解决方案，亲测有效：

这个方法能一次性搞定所有PopupMenu的背景，核心是在主题里关联自定义的PopupMenu样式：

首先在styles.xml里定义PopupMenu专属样式：

<!-- 自定义PopupMenu基础样式 -->
<style name="CustomPopupMenu" parent="@style/Widget.AppCompat.PopupMenu">
    <!-- 设置菜单整体背景色 -->
    <item name="android:background">@color/your_custom_bg_color</item>
    <!-- 可选：如果需要修改菜单项的文字颜色、分隔线，可嵌套子样式 -->
    <item name="popupMenuStyle">@style/CustomPopupMenuInner</item>
</style>

<!-- 针对Overflow菜单的细化样式 -->
<style name="CustomPopupMenuInner" parent="@style/Widget.AppCompat.PopupMenu.Overflow">
    <item name="android:background">@color/your_custom_bg_color</item>
</style>

然后在你的AppTheme里添加关联属性，覆盖默认样式：

<style name="AppTheme" parent="Theme.AppCompat.Light.DarkActionBar">
    <!-- 保留你原有的主题属性 -->
    <item name="colorPrimary">@color/colorPrimary</item>
    <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
    
    <!-- 新增：关联自定义PopupMenu样式 -->
    <item name="popupMenuStyle">@style/CustomPopupMenu</item>
    <!-- 重点：如果是Toolbar的溢出菜单，必须加这行，很多人就是漏了这个导致不生效 -->
    <item name="actionOverflowMenuStyle">@style/CustomPopupMenu</item>
</style>

如果只是某个特定的PopupMenu需要改背景，不想全局修改，可以用反射获取PopupMenu的底层弹窗，直接设置背景：

PopupMenu popupMenu = new PopupMenu(context, yourAnchorView);
// 填充菜单布局
popupMenu.getMenuInflater().inflate(R.menu.your_menu_layout, popupMenu.getMenu());

// 通过反射获取弹窗实例，设置背景
try {
    Field popupField = popupMenu.getClass().getDeclaredField("mPopup");
    popupField.setAccessible(true);
    MenuPopupHelper popupHelper = (MenuPopupHelper) popupField.get(popupMenu);
    // 用自定义drawable做背景（可以是纯色或带圆角的shape）
    popupHelper.getPopup().setBackgroundDrawable(ContextCompat.getDrawable(context, R.drawable.bg_popup_custom));
} catch (Exception e) {
    e.printStackTrace();
}

// 显示菜单
popupMenu.show();

其中bg_popup_custom.xml可以是带圆角的纯色背景：

<shape xmlns:android="http://schemas.android.com/apk/res/android">
    <solid android:color="@color/your_custom_color"/>
    <corners android:radius="8dp"/> <!-- 可选，让菜单更美观 -->
</shape>

如果上面的方法还是不生效，大概率是有其他样式覆盖了你的设置：

• 检查所有styles.xml文件，有没有其他地方定义了popupMenuStyle或actionOverflowMenuStyle
• 确保自定义样式的parent是AppCompat系列（比如Widget.AppCompat.PopupMenu），不要用原生的Widget.PopupMenu，AppCompat会替换原生控件，原生样式不生效

我之前踩过坑，就是漏加了actionOverflowMenuStyle，导致Toolbar的溢出菜单一直是默认背景，加上之后立刻就生效了，你可以重点检查这个点！

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