Android AIDL IPC无法调用服务问题排查求助

• AIDL文件一致性问题
  确保ipc_library里的AIDL文件在ipc_server和ipc_client中完全一致——包名、接口方法、参数类型甚至注释换行都不能有差异，哪怕一点不同都会导致Binder无法匹配，系统不会触发回调。

• 服务清单配置错误

  • 检查ipc_server中Service的android:name是否精准指向实现类，别写错类名或包名。
  • 必须给Service加上android:exported="true"，跨进程调用必须允许外部应用访问；如果用了自定义权限，客户端也要同步声明对应权限。
  • 若设置了android:process属性，确认进程名格式正确（比如:remote这种独立进程写法），避免进程启动失败。

• 绑定服务的Intent匹配问题

  • 客户端绑定必须用显式Intent，指定服务的完整类名，比如：

    new Intent().setComponent(new ComponentName("com.example.ipc_server", "com.example.ipc_server.MyRemoteService"))
    

    Android 5.0+后跨进程绑定不能用隐式Intent，直接会失败。
  • 别给Intent加多余的Action或Category，避免匹配不到服务。

• Service的onBind方法返回值错误
  确认服务的onBind()返回的是AIDL生成的Stub类实例，不能是null或其他Binder对象。示例：

  @Override
  public IBinder onBind(Intent intent) {
      return new IMyAidlInterface.Stub() {
          @Override
          public String getValue() throws RemoteException {
              return "远程服务返回值";
          }
      };
  }
  

  返回null的话，绑定直接失败，不会触发onServiceConnected。

• 客户端ServiceConnection的注册问题

  • 确保bindService()传入的ServiceConnection对象没被提前回收（比如匿名内部类所在Activity销毁，可能导致回调失效）。
  • bindService()的第三个参数必须传Context.BIND_AUTO_CREATE，否则服务未启动时不会自动创建，绑定流程卡壳。

• Android 11+的包可见性限制
  如果客户端targetSdkVersion是30及以上，必须在AndroidManifest.xml中添加服务端包名到<queries>标签：

  <queries>
      <package android:name="com.example.ipc_server" />
  </queries>
  

  否则系统会阻止客户端访问服务端应用。

• 异步绑定的时序问题
  绑定服务是异步操作，不能调用bindService()后立刻调用AIDL方法，必须等onServiceConnected回调拿到Binder对象后再执行远程调用，不然肯定返回null。

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