Android 10中Firebase Realtime Database onComplete未调用求助

这个问题很典型，Android 10（API 29）引入的后台执行限制是导致你遇到问题的核心原因。当你的App进入后台（onPause之后系统很快会把App标记为后台进程），Firebase Realtime Database的异步网络请求会被系统限制，导致updateChildren的onComplete回调无法触发——系统直接中断了后台的网络操作，任务根本没机会完成。

下面给你几个可行的解决方案，按推荐优先级排序：

1. 优先使用Firebase官方的在线状态方案（onDisconnect） #

这是Firebase专门为在线/离线状态场景设计的API，比自己通过Activity生命周期处理可靠得多，即使App被系统杀死、设备重启或网络断开，也能自动设置离线状态。

核心思路是：在App初始化时，预先设置断开连接时要执行的操作（设置离线状态），然后在onResume时主动设置在线状态。这样不需要依赖onPause，因为Firebase会在检测到连接断开时自动触发离线更新。

示例代码：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_chat);

    // 初始化用户状态监听（只需要执行一次）
    setupUserStatusListener();
}

private void setupUserStatusListener() {
    if (myUserId == null) return;

    DatabaseReference userStatusRef = FirebaseDatabase.getInstance()
            .getReference(Constants.getInstance().fb_table_user)
            .child(myUserId)
            .child("status");

    // 设置断开连接时的操作：自动将状态设为离线
    userStatusRef.onDisconnect().setValue(Constants.getInstance().userStatusOffline)
            .addOnCompleteListener(task -> {
                if (task.isSuccessful()) {
                    Log.e(TAG, "✅ 断开连接时的离线状态已预设");
                } else {
                    Log.e(TAG, "❌ 预设离线状态失败: " + task.getException().getMessage());
                }
            });

    // App启动时先设置在线状态
    updateUserStatus(Constants.getInstance().userStatusOnline);
}

@Override
protected void onResume() {
    super.onResume();
    // 恢复前台时再次确认在线状态（防止App从后台被恢复时连接已断开）
    updateUserStatus(Constants.getInstance().userStatusOnline);
}

private void updateUserStatus(String status) {
    if (myUserId == null) return;

    FirebaseDatabase.getInstance()
            .getReference(Constants.getInstance().fb_table_user)
            .child(myUserId)
            .child("status")
            .setValue(status)
            .addOnCompleteListener(task -> {
                Log.e(TAG, "更新状态为[" + status + "]结果: " + task.isSuccessful());
            });
}

这种方案完全避开了Android后台限制的问题，因为onDisconnect的操作是在Firebase服务器端注册的，只要客户端之前和服务器建立过连接，即使客户端被杀死，服务器检测到连接断开后会自动执行预设的写操作。

2. 用前台Service执行后台状态更新（如果必须依赖onPause） #

如果你的业务逻辑必须在onPause时立即更新状态，可以使用前台Service来执行这个操作——前台Service拥有更高的系统优先级，不会被Android 10的后台限制打断，但需要显示一个低优先级的通知（这是系统强制要求）。

步骤1：创建前台Service

public class StatusUpdateService extends Service {
    private static final int NOTIFICATION_ID = 1001;
    private static final String CHANNEL_ID = "user_status_channel";

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        // Android O及以上需要创建通知渠道
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            NotificationChannel channel = new NotificationChannel(
                    CHANNEL_ID,
                    "用户状态更新",
                    NotificationManager.IMPORTANCE_LOW
            );
            NotificationManager manager = getSystemService(NotificationManager.class);
            manager.createNotificationChannel(channel);
        }

        // 构建前台通知（必须显示）
        Notification notification = new NotificationCompat.Builder(this, CHANNEL_ID)
                .setContentTitle("正在更新状态")
                .setContentText("设置用户为离线状态")
                .setSmallIcon(R.drawable.ic_app_icon) // 替换成你的应用图标
                .setPriority(NotificationCompat.PRIORITY_LOW)
                .build();

        // 启动前台服务
        startForeground(NOTIFICATION_ID, notification);

        // 从Intent获取参数
        String status = intent.getStringExtra("STATUS");
        String userId = intent.getStringExtra("USER_ID");

        if (userId != null && status != null) {
            // 执行Firebase更新操作
            DatabaseReference userRef = FirebaseDatabase.getInstance()
                    .getReference(Constants.getInstance().fb_table_user)
                    .child(userId);
            HashMap<String, Object> updateMap = new HashMap<>();
            updateMap.put("status", status);

            userRef.updateChildren(updateMap).addOnCompleteListener(task -> {
                Log.e("StatusService", "状态更新结果: " + task.isSuccessful());
                // 更新完成后停止前台服务
                stopForeground(true);
                stopSelf();
            });
        } else {
            // 参数错误，直接停止服务
            stopForeground(true);
            stopSelf();
        }

        return START_NOT_STICKY;
    }

    @Nullable
    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

步骤2：在AndroidManifest中注册Service

<service android:name=".StatusUpdateService" />

步骤3：在Activity的onPause中启动Service

@Override
protected void onPause() {
    super.onPause();
    if (myUserId != null) {
        Intent intent = new Intent(this, StatusUpdateService.class);
        intent.putExtra("STATUS", Constants.getInstance().userStatusOffline);
        intent.putExtra("USER_ID", myUserId);

        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            startForegroundService(intent);
        } else {
            startService(intent);
        }
    }
}

3. 额外检查：确认Firebase规则权限 #

虽然你说其他版本正常，但还是建议检查你的Realtime Database规则，确保当前用户有status字段的写权限。比如：

{
  "rules": {
    "fb_table_user": {
      "$userId": {
        ".write": "$userId === auth.uid", // 只有当前用户能修改自己的状态
        ".read": true
      }
    }
  }
}

如果权限不足，也可能导致updateChildren的回调无法触发（不过这种情况其他版本也会失败，所以可能性较低）。

总结一下，最推荐的是第一种方案（onDisconnect），它是Firebase官方针对在线状态场景的最优解，完全避开了Android版本的后台限制问题，可靠性最高。

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