解决SplashActivity的Theme.AppCompat主题异常问题

云原生阿岚

2026-7-5

解决方案

1. 检查Activity继承类

确认SplashActivity继承的是AppCompatActivity，而非原生Activity——AppCompat主题要求Activity必须继承这类兼容类：

public class SplashActivity extends AppCompatActivity {
    // 你的业务代码
}

2. 锁定Manifest里的Activity主题

确保AndroidManifest.xml中SplashActivity明确绑定AppTheme.NoActionBar，防止被默认主题覆盖：

<activity
    android:name=".splash.ui.SplashActivity"
    android:theme="@style/AppTheme.NoActionBar">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

3. 确认主题定义无冲突

检查styles.xml（包括不同API版本的values-vXX目录下的文件）中AppTheme.NoActionBar的父主题是否正确：

<style name="AppTheme.NoActionBar" parent="Theme.AppCompat.Light.NoActionBar">
    <!-- 自定义主题属性 -->
    <item name="colorPrimary">@color/colorPrimary</item>
    <item name="colorPrimaryDark">@color/colorPrimaryDark</item>
    <item name="colorAccent">@color/colorAccent</item>
</style>

4. 覆盖依赖库的主题干扰

esp-idf-provisioning-android库可能自带主题配置，可在Manifest的activity标签里强制指定主题并添加覆盖标记：

<!-- 先在Manifest根标签添加tools命名空间：xmlns:tools="http://schemas.android.com/tools" -->
<activity
    android:name=".splash.ui.SplashActivity"
    android:theme="@style/AppTheme.NoActionBar"
    tools:replace="android:theme">
    <!-- 其他配置 -->
</activity>