Android Oreo及以上Widget前台服务失效：点击无响应问题求助

你遇到的这个问题核心在于Android Oreo（API 26）及以上的后台服务启动限制，再加上IntentService的自动销毁特性，导致一段时间后点击Widget触发的服务启动被系统拦截。具体来说：

1. IntentService的自动停止特性：你的UpdateService继承自IntentService，它的工作机制是在onHandleIntent执行完任务后自动调用stopSelf()销毁服务。第一次点击Widget时，服务启动并进入前台（你在onCreate里调用了startForeground），任务完成后服务就被销毁了。
2. 后台启动服务限制：当服务销毁后，再次点击Widget触发PendingIntent.getService()启动服务时，此时你的应用可能处于后台状态，Android系统会阻止这种后台启动服务的行为，于是就出现了日志里的Background start not allowed错误。

针对这个问题，我们可以从两个关键地方修改代码，彻底解决点击失效的问题：

1. 替换PendingIntent.getService()为前台服务专用的PendingIntent #

从Android 12（API 31）开始，启动前台服务必须使用PendingIntent.getForegroundService()，而在Oreo到Android 11之间，虽然系统允许用getService()，但明确标记为前台服务的启动会更安全。修改updateViews方法里的PendingIntent创建代码：

private static void updateViews(Context context) {
    RemoteViews views = new RemoteViews(context.getPackageName(), R.layout.wod_widget);
    WodData wd = WodData.getInstance();
    views.setTextViewText(R.id.appwidget_text, "foobar");

    Intent intent = new Intent(Clicks.ACTION_CLICK, null, context, UpdateService.class);
    PendingIntent pendingIntent;

    // 根据系统版本选择合适的PendingIntent创建方式
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        // Android 12+ 必须使用getForegroundService
        pendingIntent = PendingIntent.getForegroundService(
            context, 
            0, 
            intent, 
            PendingIntent.FLAG_IMMUTABLE // 推荐使用IMMUTABLE，避免安全风险
        );
    } else {
        pendingIntent = PendingIntent.getService(
            context, 
            0, 
            intent, 
            PendingIntent.FLAG_UPDATE_CURRENT // 更新现有PendingIntent，避免重复创建
        );
    }

    views.setOnClickPendingIntent(R.id.layoutWidget, pendingIntent);
    ComponentName thisWidget = new ComponentName(context, WodWidget.class);
    AppWidgetManager.getInstance(context).updateAppWidget(thisWidget, views);
}

2. 改用普通Service替代IntentService #

IntentService的自动销毁特性是导致问题的根源之一，我们可以改用普通Service，手动管理工作线程，确保服务在完成任务后可以安全停止，同时保证启动时始终处于前台状态：

public static class UpdateService extends Service {
    private static final String TAG = "WodWidgetUpdateService";
    private final Handler mHandler = new Handler();
    private ExecutorService mExecutorService; // 用于处理后台任务的线程池

    public UpdateService() {
        super();
        mExecutorService = Executors.newSingleThreadExecutor();
    }

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

    @Override
    public void onCreate() {
        super.onCreate();
        // 创建前台服务通知通道（仅需创建一次，但重复创建也不会报错）
        String channelId = "foobar";
        String channelName = "Widget update service";
        NotificationChannel channel = new NotificationChannel(
            channelId, 
            channelName, 
            NotificationManager.IMPORTANCE_LOW // 用IMPORTANCE_LOW替代NONE，避免通知被隐藏
        );
        NotificationManager manager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
        manager.createNotificationChannel(channel);

        // 启动前台服务
        Notification notification = new Notification.Builder(getApplicationContext())
            .setChannelId(channelId)
            .setContentTitle("Widget正在刷新")
            .setContentText("请稍候...")
            .setSmallIcon(R.drawable.ic_widget_small) // 必须设置小图标，否则通知会显示异常
            .build();
        startForeground(1, notification);
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        // 在后台线程处理任务
        mExecutorService.execute(() -> {
            if (Clicks.ACTION_CLICK.equals(intent.getAction())) {
                Clicks.handleClickAction(this, mHandler);
            } else {
                getWodData(this);
            }
            // 任务完成后停止服务
            stopSelf(startId);
        });
        // 服务被系统杀死后不自动重启
        return START_NOT_STICKY;
    }

    @Override
    public void onDestroy() {
        super.onDestroy();
        mExecutorService.shutdown(); // 关闭线程池，释放资源
    }

    protected void getWodData(final Context context) {
        WodData.getInstance().invalidate();
        WodWidget.updateViews(context);
        GetHTMLTask task = new GetHTMLTask(() -> {
            WodWidget.updateViews(context);
        });
        task.execute(WodData.PARSE_URL);
    }
}

这里的关键改进点： #

• 使用ExecutorService手动管理后台线程，替代IntentService的自动线程管理
• 在onStartCommand中处理任务，完成后调用stopSelf()停止服务
• 通知通道使用IMPORTANCE_LOW，既满足前台服务要求，又不会打扰用户
• 必须设置通知的smallIcon，否则前台服务启动会失败

额外注意事项 #

• 确保你的AndroidManifest.xml中已经声明了前台服务权限：

  <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
  <!-- Android 13+ 还需要POST_NOTIFICATIONS权限 -->
  <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
  

• 对于Android 13及以上版本，需要动态申请POST_NOTIFICATIONS权限，否则前台服务的通知无法显示，服务启动可能失败。

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