使用RunOnUIThread方法时Toast不显示的问题排查

我一直在排查Toast无法显示的问题：从代码来看，onReceive方法确实已执行（按钮颜色已成功修改），但Toast始终无法显示，找不到问题原因。

相关代码 #

client = new Client(
        (publisher, topic, params) -> runOnUiThread(
                () -> onReceive((Publisher) publisher, topic, params)
        ));

client.connectToServer("192.168.3.52",5050);

private void onReceive(Publisher publisher, String topic, Map<String, Object> params) {
    sendBtn.setBackgroundColor(getColor(R.color.white));
    Toast.makeText(MainActivity.this, "Hey", Toast.LENGTH_LONG).show();
}

导入包 #

import android.app.AlertDialog;
import android.content.DialogInterface;
import android.content.Intent;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageView;
import android.widget.TextView;
import android.widget.Toast;

import androidx.annotation.Nullable;
import androidx.appcompat.app.AppCompatActivity;

import java.io.Serializable;
import java.time.LocalDateTime;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import java.util.stream.Collectors;

类定义 #

public class MainActivity extends AppCompatActivity {

排查方向 #

• 验证Context有效性：调用Toast时，确认Activity未被销毁。可添加日志打印MainActivity.this.isFinishing()或MainActivity.this.isDestroyed()的结果，判断当前Activity状态。
• 显式绑定主线程Looper：尝试修改Toast代码，强制绑定主线程Looper，避免UI线程Looper异常：

  import android.os.Looper;
  
  // ...
  
  Toast toast = Toast.makeText(MainActivity.this, "Hey", Toast.LENGTH_LONG);
  toast.setLooper(Looper.getMainLooper());
  toast.show();
  

• 检查系统/应用限制：部分定制ROM会限制后台Toast显示，可查看应用权限中是否有通知相关限制，或在系统设置中确认Toast显示权限是否开启。
• 排查Toast队列问题：若频繁触发onReceive，可能导致Toast队列阻塞或被覆盖。可尝试延长显示时长，或维护一个全局Toast实例，调用show前先执行cancel()：

  private Toast mToast;
  
  // ...
  
  if (mToast != null) {
      mToast.cancel();
  }
  mToast = Toast.makeText(MainActivity.this, "Hey", Toast.LENGTH_LONG);
  mToast.show();
  

• 查看Logcat日志：在Toast.show()前后添加日志，确认代码执行路径，同时搜索Logcat中Toast相关的警告或错误信息，定位潜在异常。

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