Qt6安卓前台定位服务启动后无通知且疑似崩溃问题求助

1. 先搞定独立进程的日志调试 #

看不到崩溃堆栈就没法精准定位，先解决这个：

• 打开Android Studio的Logcat，在进程筛选器中选择你的服务独立进程（对应AndroidManifest.xml里service标签的android:process属性值，比如:location_service），重点看AndroidRuntime标签的错误日志，这是崩溃的核心信息
• 在Qt代码的关键节点加日志：比如QGeoPositionInfoSource初始化前、初始化后、调用startUpdates前后，用qDebug()/qCritical()输出状态，这些日志会同步到Logcat
• 在MyService.java里添加Log.d("MyService", "xxx")日志，记录服务启动、调用Qt代码的时间点，确认JNI交互是否正常

2. 验证权限的实际授予状态 #

别只看Manifest配置，要确认权限真的生效：

• 在Qt代码中通过JNI调用Android的权限检查API：

  bool hasPermission(const QString& permission) {
      QAndroidJniObject activity = QAndroidJniObject::callStaticObjectMethod("org/qtproject/qt5/android/QtNative", "activity", "()Landroid/app/Activity;");
      QAndroidJniObject perm = QAndroidJniObject::fromString(permission);
      int result = activity.callMethod<int>("checkSelfPermission", "(Ljava/lang/String;)I", perm.object<jstring>());
      return result == QAndroidJniObject::getStaticField<int>("android/content/pm/PackageManager", "PERMISSION_GRANTED");
  }
  

  检查android.permission.ACCESS_FINE_LOCATION、android.permission.ACCESS_COARSE_LOCATION、android.permission.ACCESS_BACKGROUND_LOCATION（Android 10+）、android.permission.FOREGROUND_SERVICE_LOCATION（Android 12+）这几个权限
• 手动去应用设置页面确认：位置权限是否开启，是否允许后台访问（Android 10+必须手动开启后台权限）

3. 排查QGeoPositionInfoSource的线程问题 #

Qt位置组件依赖事件循环，独立进程的线程环境容易出问题：

• QGeoPositionInfoSource的实例必须在Qt主线程创建和操作，因为它依赖Qt事件循环处理位置更新信号。如果是在JNI触发的Qt函数里执行初始化，用QMetaObject::invokeMethod把代码抛到主线程：

  QMetaObject::invokeMethod(QCoreApplication::instance(), [this]() {
      m_positionSource = QGeoPositionInfoSource::createDefaultSource(this);
      if (m_positionSource) {
          connect(m_positionSource, &QGeoPositionInfoSource::positionUpdated, this, &YourClass::onPositionUpdated);
          connect(m_positionSource, &QGeoPositionInfoSource::errorOccurred, this, &YourClass::onPositionError);
          m_positionSource->startUpdates();
      }
  }, Qt::QueuedConnection);
  

• 确保服务进程的Qt事件循环一直在运行，不要阻塞主线程（比如不要在主线程做耗时的JNI调用或IO操作）

4. 修复startForegroundService引发的ANR #

ANR的核心原因是5秒内未调用startForeground显示通知：

• 在MyService.java的onCreate或onStartCommand方法中，优先调用startForeground显示通知，再处理Qt位置初始化逻辑：

  @Override
  public void onCreate() {
      super.onCreate();
      // 先创建通知渠道（Android 8+必须）
      createNotificationChannel();
      // 立即启动前台通知
      Notification notification = buildForegroundNotification();
      startForeground(1, notification);
      // 再异步触发Qt的位置初始化
      new Thread(() -> {
          // 调用Qt的初始化代码
          QtNative.invokeQtMethod(...);
      }).start();
  }
  

• 绝对不要在onStartCommand中直接执行可能阻塞的操作（比如Qt位置组件的初始化），必须异步处理

5. 规范QGeoPositionInfoSource的使用 #

• 初始化前先检查可用位置源：

  QStringList sources = QGeoPositionInfoSource::availableSources();
  qDebug() << "Available position sources:" << sources;
  if (sources.isEmpty()) {
      qCritical() << "No position sources available!";
      return;
  }
  

• 避免重复创建实例，确保一个服务周期内只有一个QGeoPositionInfoSource实例，不需要时调用stopUpdates()和deleteLater()释放资源
• 除了绑定errorOccurred，还要绑定positionUpdated信号，哪怕没有位置更新，也能确认组件是否在正常运行
• 先用requestUpdate(5000)（5秒内请求一次单次更新）替代startUpdates，测试单次更新是否正常，逐步排查问题

6. 最小化案例测试 #

创建一个极简测试项目：

1. 只实现前台服务，确保通知能正常显示
2. 逐步添加QGeoPositionInfoSource的初始化、单次更新请求代码
3. 每添加一步测试一次，定位到具体哪一行代码导致通知失效或崩溃

内容的提问来源于stack exchange，提问作者Ивелин Иванов