Android绑定AIDL远程服务失败，Intent匹配问题求助

问题描述 #

开发了一个包含两个AIDL文件和一个Service的Android应用，该Service需供其他应用调用AIDL定义的方法。按官方规范实现后，客户端应用绑定服务时bindService始终返回false，提示Intent无法找到。尝试多种Intent写法均无效，但在Service所在应用内直接用Intent(this, MyService.class)可正常绑定。

尝试过的Intent写法包括：

Intent intent = new Intent("a.b.c.service");
intent.setPackage("a.b.c");

// ---

Intent intent = new Intent("service");
intent.setPackage("a.b.c");

// ---

Intent intent = new Intent();
intent.setClassName("a.b.c", "a.b.c.services.MyService");

// ---

Intent intent = new Intent();
intent.setClassName("a.b.c.services", "a.b.c.services.MyService");

// ---

Intent intent = new Intent();
intent.setClassName("a.b.c", ".services.MyService");

// ---

Intent intent = new Intent();
intent.setAction("service");
intent.setPackage("a.b.c");
intent.setClassName("a.b.c", ".services.MyService");

// ---

Intent intent = new Intent();
intent.setAction("service");
intent.setClassName("a.b.c", ".services.MyService");

相关代码 #

IServiceInterface.aidl

package a.b.c;

import a.b.c.IServiceInterfaceGetStuffCallback;

interface IServiceInterface
{
    void getStuff(String arg1, IServiceInterfaceGetStuffCallback callback);
}

IServiceInterfaceGetStuffCallback.aidl

package a.b.c;

interface IServiceInterfaceGetStuffCallback
{
    void onGetStuffResponse(String arg1, boolean arg2, int arg3, int arg4);
}

MyService.java

public class MyService extends Service
{
    private final MyService self = this;
    private MyServiceHandler handler = null;
    private final HandlerThread handlerThread = new HandlerThread("AidlServiceThread");

    //Callbacks
    private final ArrayList<IServiceInterfaceGetStuffCallback> getStuffCallbacks = new ArrayList<>();

    private final int MY_SERVICE_GET_STUFF_MSG = 1;

    public MyService()
    {
    }

    @Override
    public IBinder onBind(Intent intent)
    {
        // Handler Thread handling all callback methods
        handlerThread.start();
        handler = new MyServiceHandler(handlerThread.getLooper());

        return mBinder;
    }

    IServiceInterface.Stub mBinder = new IServiceInterface.Stub()
    {
        @Override
        public void getStuff(String arg1, IServiceInterfaceGetStuffCallback callback) throws RemoteException
        {
            //Register the callback internally
            getStuffCallbacks.add(callback);
            final int cbIndex = getStuffCallbacks.size() - 1;

            getStuff((arg1, arg2, arg3, arg4) ->
            {
                MyServiceResponse response = new MyServiceResponse();
                response.arg1 = arg1;
                response.arg2 = arg2;
                response.arg3 = arg3;
                response.arg4 = arg4;

                Message message = handler.obtainMessage();
                message.arg1 = cbIndex;
                message.obj = response;
                message.what = MY_SERVICE_GET_STUFF_MSG;

                handler.sendMessage(message);
            });
        }
    };

    private class MyServiceHandler extends Handler
    {
        int callbackIndex = 0;

        MyServiceHandler (Looper looper)
        {
            super(looper);
        }

        @Override
        public void handleMessage(Message msg)
        {
            callbackIndex = msg.arg1;
            MyServiceResponse response = (MyServiceResponse)msg.obj;

            switch (msg.what)
            {
                case MY_SERVICE_GET_STUFF_MSG:
                {
                    try
                    {                        
getStuffCallbacks.get(callbackIndex).onGetStuffResponse(response.arg1, response.arg2, response.arg3, response.arg4);
                    }
                    catch (RemoteException e)
                    {
                        e.printStackTrace();
                    }

                    break;
                }
                default:
                    break;
            }
        }
    }

    private static class MyServiceResponse
    {
        public String arg1;
        public boolean arg2;
        public int arg3;
        public int arg4;
    }
}

服务端AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="a.b.c">

    <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
    <uses-permission android:name="android.permission.INTERNET" />

    <permission
        android:name="a.b.c.myservice"
        android:protectionLevel="signature" />

    <application
        android:name=".MyApplication"
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:supportsRtl="true"
        android:theme="@style/AppTheme"
        android:configChanges="orientation|screenSize|screenLayout|keyboardHidden|keyboard|colorMode|density|navigation|fontScale|layoutDirection|locale|mcc|mnc|smallestScreenSize|touchscreen|uiMode">

        (...)

        <service
            android:name="a.b.c.services.MyService"
            android:enabled="true"
            android:exported="true"
            android:permission="a.b.c.myservice">
            <intent-filter>
                <action android:name="a.b.c.myservice" />
            </intent-filter>
        </service>
    </application>

</manifest>

客户端MainActivity.java

public class MainActivity extends AppCompatActivity implements View.OnClickListener
{
    private final String TAG = "aidltest";

    MainActivity self = this;
    IServiceInterface service = null;

    @Override
    protected void onCreate(Bundle savedInstanceState)
    {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        findViewById(R.id.btn_get_stuff).setOnClickListener(this);
    }

    @Override
    public void onClick(View view)
    {
        if (view.getId() == R.id.btn_get_stuff)
            getStuff();
    }

    void getStuff()
    {
        Log.e(TAG, "getStuff invoked");

        Intent intent = new Intent("a.b.c.myservice");
        intent.setPackage("a.b.c");

        boolean res = getApplicationContext().bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE);

        Log.e(TAG, "Service binding result: " + res);
    }

    private ServiceConnection serviceConnection = new ServiceConnection()
    {
        public void onServiceConnected(ComponentName className, IBinder service)
        {
            self.service = IServiceInterface.Stub.asInterface(service);

            Log.e(TAG, "ServiceInterface attached");
        }

        public void onServiceDisconnected(ComponentName className)
        {
            service = null;
            Log.e(TAG, "Service disconnected");
        }
    };
}

解决方案 #

1. 添加客户端权限声明 #

Service配置了android:permission="a.b.c.myservice"，且权限的protectionLevel为signature，要求客户端必须声明使用该权限，且和服务端用相同签名打包。

在客户端AndroidManifest.xml中添加：

<uses-permission android:name="a.b.c.myservice" />

2. 确保Intent匹配逻辑正确 #

从服务端Manifest来看，Service的intent-filter action为a.b.c.myservice，客户端只需用action + package的方式构建Intent即可，无需额外指定className：

Intent intent = new Intent("a.b.c.myservice");
intent.setPackage("a.b.c");

同时确认服务端Manifest中Service的android:name和实际类路径完全一致（当前配置a.b.c.services.MyService是正确的）。

3. 验证签名一致性 #

因为权限是signature级别，客户端和服务端必须使用同一个签名文件打包。测试阶段确保两个应用都使用Android Studio默认的debug签名，若手动修改过签名配置，需保证签名文件一致。

4. 额外排查点 #

• 确认服务端应用已安装且未被系统杀死；
• 查看Logcat日志，若存在SecurityException，说明权限或签名配置有问题；
• 不要同时在Intent中设置action和className，会导致匹配冲突。

修正后的客户端绑定代码 #

添加权限后，使用以下代码即可正常绑定：

void getStuff() {
    Log.e(TAG, "getStuff invoked");

    Intent intent = new Intent("a.b.c.myservice");
    intent.setPackage("a.b.c");

    boolean res = bindService(intent, serviceConnection, Context.BIND_AUTO_CREATE);

    Log.e(TAG, "Service binding result: " + res);
}

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