Android中如何将带回调的TextToSpeech包装为阻塞初始化函数？

问题根源 #

你遇到的卡死是典型的主线程死锁：

• TextToSpeech的初始化回调固定在应用主线程触发（这是Android系统的设计，和构造函数调用线程无关）
• 你在主线程调用了cdl.await()，导致主线程被挂起，无法执行回调里的cdl.countDown()，Latch永远无法触发，应用彻底卡死

正确实现方式 #

核心原则：永远不要在主线程等待必须由主线程执行的操作。我们需要把等待逻辑放到后台线程，让主线程可以正常处理回调。

方案1：用Future封装后台阻塞逻辑

把初始化和等待逻辑全部放到后台线程，通过Future返回初始化完成的TextToSpeech实例：

private TextToSpeech mEngine;
private final ExecutorService executorService = Executors.newSingleThreadExecutor();

/**
 * 阻塞初始化TextToSpeech，需在后台线程调用（或调用时处理主线程阻塞风险）
 */
public TextToSpeech initializeBlocking() throws InterruptedException, ExecutionException, TimeoutException {
    Future<TextToSpeech> initFuture = executorService.submit(() -> {
        CountDownLatch latch = new CountDownLatch(1);
        AtomicReference<TextToSpeech> ttsRef = new AtomicReference<>();

        // 在后台线程构造TTS，回调会自动到主线程
        ttsRef.set(new TextToSpeech(mContext, status -> {
            // 可在这里判断初始化状态，比如仅成功才触发latch
            if (status == TextToSpeech.SUCCESS) {
                latch.countDown();
            } else {
                // 初始化失败时可以抛出异常或处理错误
                latch.countDown();
            }
        }, ENGINE_GOOGLE_NAME));

        // 后台线程等待回调完成，设置超时避免无限等待
        latch.await(10, TimeUnit.SECONDS);
        return ttsRef.get();
    });

    // 如果在主线程调用此方法，get()会阻塞主线程，建议仅在后台线程调用
    return initFuture.get(10, TimeUnit.SECONDS);
}

方案2：避免阻塞，改用异步回调（推荐）

Android主线程不允许长时间阻塞（超过5秒会触发ANR），所以更推荐保留异步回调的设计，只在需要时等待后台线程的初始化结果：

private TextToSpeech mEngine;
private final ExecutorService executorService = Executors.newSingleThreadExecutor();

/**
 * 异步初始化，通过回调返回结果
 */
public void initializeAsync(TtsInitCallback callback) {
    executorService.execute(() -> {
        mEngine = new TextToSpeech(mContext, status -> {
            if (status == TextToSpeech.SUCCESS) {
                callback.onSuccess(mEngine);
            } else {
                callback.onFailure(status);
            }
        }, ENGINE_GOOGLE_NAME);
    });
}

// 定义回调接口
public interface TtsInitCallback {
    void onSuccess(TextToSpeech engine);
    void onFailure(int statusCode);
}

关键注意事项 #

• 无论哪种方案，都不要在主线程直接调用await()或Future.get()，否则依然会有ANR风险
• 初始化失败时要处理错误状态（比如status == TextToSpeech.ERROR），避免Latch永远等待
• 使用完ExecutorService后记得关闭，避免内存泄漏

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