为何Class.getDeclaredMethods()会返回继承的默认方法？

当调用Class.getDeclaredMethods()时，按Java规范应该只返回当前类直接声明的方法，不包含继承的方法。但在Android中出现了特殊情况：

• 直接通过Android Studio安装应用（无论构建变体是Debug还是Release），该方法行为正常；
• 仅当编译成APK/App Bundle（.aab）后安装（包括直接复制APK到设备或通过Google Play发布安装）时，会返回接口中的默认方法，不符合预期。

测试场景说明：
在全新Android Studio项目中验证，配置如下：

• SDK 33，minSdk 21（Android 5.0）
• minifyEnabled=false，移除默认proguard配置，排除R8/ProGuard混淆导致问题的可能

接口代码（TestInterface.java） #

package com.example.testapp;

public interface TestInterface {
    default String methodWithDefault() {
        return "default";
    }

    String methodWithoutDefault();
}

实现类代码（TestClass.java） #

package com.example.testapp;

public class TestClass implements TestInterface {
    @Override
    public String methodWithoutDefault() {
        return "non-default";
    }
}

测试代码（MainActivity.java） #

package com.example.testapp;

import android.os.Bundle;
import android.widget.TextView;

import androidx.appcompat.app.AppCompatActivity;

import java.lang.reflect.InvocationTargetException;
import java.lang.reflect.Method;

public class MainActivity extends AppCompatActivity {

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

        TestClass test = new TestClass();
        StringBuilder sb = new StringBuilder("Methods:\n");
        for (Method m : TestClass.class.getDeclaredMethods()) {
            sb.append('\n').append(m.toString()).append('\n');
            try {
                String s = (String) m.invoke(test);
                sb.append("Result: ").append(s).append('\n');
            } catch (InvocationTargetException e) {
                sb.append("Target exception: ").append(e.getTargetException()).append('\n');
            } catch (IllegalAccessException e) {
                sb.append("Illegal access.\n");
            }
        }

        System.out.println(sb);

        TextView textView = findViewById(R.id.textView);
        textView.setText(sb.toString());
    }
}

项目配置（app/build.gradle） #

plugins {
    id 'com.android.application'
}

android {
    namespace 'com.example.testapp'
    compileSdk 33

    defaultConfig {
        applicationId "com.example.testapp"
        minSdk 21
        targetSdk 33
        versionCode 1
        versionName "1.0"
    }

    buildTypes {
        release {
            minifyEnabled false
        }
    }
    compileOptions {
        sourceCompatibility 11
        targetCompatibility 11
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.5.1'
    implementation 'com.google.android.material:material:1.7.0'
    implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
}

输出对比 #

直接从Android Studio运行的输出 #

Methods:

public java.lang.String com.example.testapp.TestClass.methodWithoutDefault()
Result: non-default

编译APK并安装后的输出 #

Methods:

public java.lang.String com.example.testapp.TestClass.methodWithDefault()
Result: default

public java.lang.String com.example.testapp.TestClass.methodWithoutDefault()
Result: non-default

问题解答 #

1. 为什么会出现这种情况？ #

这是Android构建工具的**dex编译器（D8）**在编译APK时的特殊兼容处理导致的：

• 由于minSdk 21（Android 5.0）不支持Java 8的默认接口方法，D8会自动将接口中的默认方法合成到实现类中，以此来适配低版本系统；
• 直接从Android Studio运行时，使用的是调试构建流程，D8未执行该合成操作，因此实现类中没有额外生成的方法；
• 编译正式APK/App Bundle时，D8会完成兼容处理，将默认方法的字节码插入到实现类中，此时getDeclaredMethods()会把这个合成方法识别为类的“直接声明方法”，从而返回它。

2. 最佳的解决方法是什么？ #

有两种可行方案，可根据业务需求选择：

方案一：过滤合成的默认方法

在反射遍历方法时，通过Method.isSynthetic()判断是否是D8合成的方法，直接过滤：

for (Method m : TestClass.class.getDeclaredMethods()) {
    if (m.isSynthetic()) {
        continue; // 跳过合成方法
    }
    // 后续业务逻辑
}

该方案无需修改构建配置，兼容性好，适合需要保留minSdk 21的场景。

方案二：升级minSdk版本到24及以上

如果业务允许将minSdk提升到24（Android 7.0），由于Android 7.0及以上原生支持Java 8默认接口方法，D8不会再执行合成操作，getDeclaredMethods()的行为会完全符合Java规范。只需修改build.gradle中的配置：

defaultConfig {
    // ...其他配置项
    minSdk 24
}

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