SyncAdapter onPerformSync仅首次调用问题（OPPO Realme设备）

我非常理解你的困扰——国产ROM的后台限制一直是Android开发者的头疼问题，尤其是Realme/OPPO的ColorOS，对后台进程管控特别严格。你已经把SyncAdapter的基础框架搭好了，现在只需要针对这些设备的特性做一些优化，再加上必要的兜底方案，就能解决问题。

一、先排查代码里的关键细节 #

你期望的是1小时同步一次，但看你的MainActivity里调用的是：

syncAdapterManager.beginPeriodicSync(60*60);

而ContentResolver.addPeriodicSync()的最后一个参数pollFrequency是毫秒单位！也就是说你现在设置的是3600毫秒（3.6秒）的间隔，这显然和你的预期不符。虽然你说首次调用正常，但这个参数错误可能会导致系统的同步调度逻辑混乱，先把它修正为：

syncAdapterManager.beginPeriodicSync(60*60*1000); // 1小时 = 3600秒 = 3600*1000毫秒

二、针对Realme设备的核心优化 #

ColorOS的后台杀进程策略会直接影响SyncAdapter的运行，哪怕它在独立进程里。我们需要从系统权限和代码逻辑两方面入手：

1. 引导用户开启必要的后台权限 #

必须让用户手动开启以下权限，否则任何后台逻辑都可能被系统干掉：

• 自启动权限：设置 → 应用管理 → 你的应用 → 权限管理 → 自启动 → 允许
• 后台活动权限：设置 → 应用管理 → 你的应用 → 耗电管理 → 允许后台活动
• 禁用电池优化：设置 → 电池 → 电池优化 → 找到你的应用 → 选择「不优化」

你可以在应用里添加权限检测逻辑，当检测到权限未开启时，弹窗引导用户跳转到对应设置页面。比如检测电池优化的代码：

private boolean isBatteryOptimizationDisabled(Context context) {
    PowerManager powerManager = (PowerManager) context.getSystemService(Context.POWER_SERVICE);
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        return !powerManager.isDeviceIdleMode() && !powerManager.isIgnoringBatteryOptimizations(context.getPackageName());
    }
    return true;
}

// 引导用户关闭电池优化
private void requestDisableBatteryOptimization(Context context) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        Intent intent = new Intent(Settings.ACTION_REQUEST_IGNORE_BATTERY_OPTIMIZATIONS);
        intent.setData(Uri.parse("package:" + context.getPackageName()));
        context.startActivity(intent);
    }
}

2. 给SyncAdapter添加唤醒锁 #

在同步过程中持有唤醒锁，让系统知道这个进程正在执行重要任务，避免被中途杀死。修改你的onPerformSync方法：

@Override
public void onPerformSync(Account account, Bundle bundle, String s, ContentProviderClient contentProviderClient, SyncResult syncResult) {
    PowerManager powerManager = (PowerManager) getContext().getSystemService(Context.POWER_SERVICE);
    // 创建部分唤醒锁，只保持CPU运行，屏幕可以关闭
    PowerManager.WakeLock wakeLock = powerManager.newWakeLock(PowerManager.PARTIAL_WAKE_LOCK, "SyncSample:SyncWakeLock");
    wakeLock.acquire(60 * 1000); // 最多持有1分钟，防止意外泄漏

    try {
        Log.e("sync","onPerformSync is called");
        showNotification(getContext(),"The query","let'see");
        // 确保同步结果标记为成功，系统才会继续触发下一次同步
        syncResult.stats.numSyncs++;
    } finally {
        if (wakeLock.isHeld()) {
            wakeLock.release();
        }
    }
}

记得在Manifest里添加唤醒锁权限：

<uses-permission android:name="android.permission.WAKE_LOCK"/>

3. 取消SyncAdapter的独立进程设置 #

你现在给ConfigurationSyncAdapterService设置了android:process=":sync"，让它运行在独立进程。但ColorOS对非主进程的后台限制更严格，建议去掉这个属性，让SyncAdapter运行在主进程里：

<service
    android:name=".ConfigurationSyncAdapterService"
    android:exported="true">
    <intent-filter>
        <action android:name="android.content.SyncAdapter"/>
    </intent-filter>
    <meta-data
        android:name="android.content.SyncAdapter"
        android:resource="@xml/syncadapter" />
</service>

4. 用AlarmManager兜底触发同步 #

即使做了以上优化，有些Realme设备还是会忽略SyncAdapter的周期性调度。这时候可以用AlarmManager来强制触发同步，作为兜底方案：

步骤1：创建广播接收器

public class SyncAlarmReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        SyncAdapterManager syncAdapterManager = new SyncAdapterManager(context);
        syncAdapterManager.syncImmediately(); // 触发即时同步
        // 重新设置下一次闹钟，保证循环触发
        syncAdapterManager.setupAlarmForSync();
    }
}

步骤2：在SyncAdapterManager里添加闹钟设置方法

void setupAlarmForSync() {
    AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
    Intent intent = new Intent(context, SyncAlarmReceiver.class);
    PendingIntent pendingIntent = PendingIntent.getBroadcast(
            context,
            0,
            intent,
            PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
    );

    long interval = 60 * 60 * 1000; // 1小时间隔
    long triggerAtMillis = System.currentTimeMillis() + interval;

    // 针对Doze模式，使用允许在空闲时触发的闹钟类型
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        alarmManager.setExactAndAllowWhileIdle(AlarmManager.RTC_WAKEUP, triggerAtMillis, pendingIntent);
    } else {
        alarmManager.setExact(AlarmManager.RTC_WAKEUP, triggerAtMillis, pendingIntent);
    }
}

步骤3：在Manifest里注册接收器

<receiver android:name=".SyncAlarmReceiver" android:enabled="true" android:exported="false"/>

步骤4：在MainActivity里启动闹钟

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    SyncAdapterManager syncAdapterManager = new SyncAdapterManager(this);
    syncAdapterManager.beginPeriodicSync(60*60*1000);
    syncAdapterManager.setupAlarmForSync(); // 启动兜底闹钟
    Log.e("sync","onCreate of Main Activity");
}

三、测试验证步骤 #

1. 先修正时间单位的错误，确保同步间隔是1小时
2. 在Realme设备上手动开启所有必要的后台权限
3. 启动应用，让它进入后台（不要手动杀死）
4. 等待1小时，查看Log和通知是否正常触发

这样一套组合拳下来，应该就能解决Realme设备上SyncAdapter周期性失效的问题了。

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