如何捕获仅API 31及以上支持的BackgroundServiceStartNotAllowedException并兼容低版本

直接按你提供的代码编写会在API31以下的编译环境中报错，因为BackgroundServiceStartNotAllowedException是Android 12（API级别31）才新增的异常类，低版本系统中不存在这个类定义。以下是两种可行的兼容方案：

方案一：版本判断+异常类型校验 #

通过先捕获通用异常，再结合API版本判断异常类型，避免编译错误：

try {
    context.startService(service);
} catch (IllegalStateException e) {
    // 处理原有IllegalStateException逻辑
    e.printStackTrace();
} catch (Exception e) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        // API31及以上，判断是否为目标异常
        if (e instanceof BackgroundServiceStartNotAllowedException) {
            // 处理BackgroundServiceStartNotAllowedException逻辑
            e.printStackTrace();
        } else {
            // 处理其他通用异常
            e.printStackTrace();
        }
    } else {
        // API31以下，直接处理通用异常
        e.printStackTrace();
    }
}

方案二：用@RequiresApi注解隔离高版本代码 #

如果希望保留单独的异常处理逻辑，可以通过@RequiresApi注解标记API31+的代码块：

try {
    context.startService(service);
} catch (IllegalStateException e) {
    e.printStackTrace();
} catch (Exception e) {
    handleServiceException(e);
}

// 单独处理异常的方法，仅在API31及以上生效
@RequiresApi(api = Build.VERSION_CODES.S)
private void handleServiceException(Exception e) {
    if (e instanceof BackgroundServiceStartNotAllowedException) {
        // 处理目标异常
        e.printStackTrace();
    } else {
        // 处理其他异常
        e.printStackTrace();
    }
}

关键注意事项 #

• 禁止直接在catch块中声明BackgroundServiceStartNotAllowedException，否则低版本编译会因找不到类而失败。
• 所有涉及该异常的类型判断必须包裹在API版本检查内，避免低版本运行时触发类加载错误。

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