三星设备初始化Android TTS返回null 异常无法捕获如何解决

问题根因 #

两个问题叠加导致异常无法捕获、偶现触发：

1. Android 11（API30）引入包可见性限制，当前配置的queries仅匹配了通用TTS服务Intent，未覆盖三星设备预装的自研TTS引擎包，系统查找TTS服务时会偶现匹配失败，直接导致TextToSpeech构造函数返回null实例。
2. 原有初始化逻辑存在空安全缺失：OnInitListener是异步回调，回调触发时存在tts变量未完成赋值、或构造阶段已返回null的可能，异常发生在系统异步回调链路中，外层包裹try-catch无法捕获。

落地修复步骤 #

• 补全清单文件的包可见性配置，替换原有queries块，加入三星TTS引擎的包声明：

<queries>
    <intent>
        <action android:name="android.intent.action.TTS_SERVICE" />
    </intent>
    <!-- 覆盖三星全版本自研TTS引擎 -->
    <package android:name="com.samsung.SMT" />
    <package android:name="com.samsung.tts" />
</queries>

• 重构TTS初始化逻辑，增加空判断、重试机制与多线程可见性防护，替换原有初始化代码：

// 增加volatile修饰，保证异步线程读取tts实例的可见性
private volatile TextToSpeech tts;
private final int MAX_INIT_RETRY_COUNT = 3;
private int currentRetryCount = 0;

private void initTts() {
    // 先释放已有实例，避免重复初始化冲突
    if (tts != null) {
        tts.shutdown();
        tts = null;
    }
    try {
        // 必须用ApplicationContext，避免Activity上下文销毁导致TTS服务断连
        tts = new TextToSpeech(getApplicationContext(), status -> {
            // 回调第一优先级判空，覆盖构造返回null的场景
            if (tts == null) {
                retryInit();
                return;
            }
            if (status == TextToSpeech.SUCCESS) {
                int langSetResult = tts.setLanguage(Locale.US);
                // 兼容三星机型默认未安装对应语音包的场景
                if (langSetResult == TextToSpeech.LANG_MISSING_DATA 
                        || langSetResult == TextToSpeech.LANG_NOT_SUPPORTED) {
                    // 可在此处加入跳转到系统语音数据下载页的逻辑
                }
            } else {
                tts = null;
                retryInit();
            }
        });
    } catch (Exception e) {
        tts = null;
        retryInit();
    }
}

private void retryInit() {
    if (currentRetryCount < MAX_INIT_RETRY_COUNT) {
        currentRetryCount++;
        // 延迟1秒重试，避开系统服务忙的时段
        new Handler(Looper.getMainLooper()).postDelayed(this::initTts, 1000);
    }
}

// 页面/服务销毁时必须释放TTS资源，避免后续初始化出现绑定异常
@Override
protected void onDestroy() {
    if (tts != null) {
        tts.stop();
        tts.shutdown();
        tts = null;
    }
    super.onDestroy();
}

• 增加TTS服务可用性前置校验，初始化前先判断系统是否存在可用TTS服务：

private boolean checkTtsAvailable() {
    Intent ttsIntent = new Intent(TextToSpeech.Engine.INTENT_ACTION_TTS_SERVICE);
    List<ResolveInfo> serviceList = getPackageManager().queryIntentServices(ttsIntent, 0);
    return serviceList != null && !serviceList.isEmpty();
}

如果校验返回false，可直接跳转系统TTS设置页，引导用户开启可用的语音引擎。

注意：不要使用Activity上下文初始化TTS，三星部分机型会在Activity生命周期切换时自动断开TTS服务绑定，导致实例突然失效触发空指针。

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