Android全局设NoActionBar主题时单Activity显示ActionBar故障排查

1 核心问题定位 #

• 崩溃原因：全局主题默认是NoActionBar，getSupportActionBar()返回null，直接调用show()触发空指针异常
• 主题不生效原因：你使用的ThemeOverlay.AppCompat.DayNight.ActionBar是主题覆盖层，不能直接作为Activity的独立主题使用，仅能用来叠加修改已有主题的部分属性，单独使用无法生效

2 具体修复步骤 #

2.1 新增带ActionBar的自定义主题 #

在你的themes.xml文件中新增如下样式，直接继承原有项目的全局基础主题，仅修改ActionBar相关配置，保证样式和全局统一：

<resources xmlns:tools="http://schemas.android.com/tools">
    <!-- 原有全局主题保持不变 -->
    <style name="Theme.Test" parent="Theme.MaterialComponents.DayNight.NoActionBar">
        <!-- 原有配置不变 -->
        <item name="colorPrimary">@color/purple_500</item>
        <item name="colorPrimaryVariant">@color/purple_700</item>
        <item name="colorOnPrimary">@color/white</item>
        <item name="colorSecondary">@color/teal_200</item>
        <item name="colorSecondaryVariant">@color/teal_700</item>
        <item name="colorOnSecondary">@color/black</item>
        <item name="android:statusBarColor" tools:targetApi="l">?attr/colorPrimaryVariant</item>
    </style>

    <!-- 新增带ActionBar的子主题 -->
    <style name="Theme.Test.WithActionBar" parent="Theme.Test">
        <item name="windowActionBar">true</item>
        <item name="windowNoTitle">false</item>
    </style>
</resources>

2.2 修改AndroidManifest的Activity配置 #

把目标Activity的主题替换为刚新增的自定义主题即可：

<activity 
    android:name=".JoinSession" 
    android:theme="@style/Theme.Test.WithActionBar"
/>

2.3 调整Activity代码 #

主题配置正确后ActionBar默认会显示，不需要手动调用show()，如果需要对ActionBar做额外配置，建议加空判断避免异常：

public class JoinSession extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_join_session);
        // 可选：需要操作ActionBar时先判空
        if (getSupportActionBar() != null) {
            getSupportActionBar().setTitle("加入会议");
            // 无需手动调用show方法，主题配置正确默认显示
        }
    }
}

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