@functionalinterface注解由编译器在编译期强制校验接口有且仅有一个未实现的抽象方法，仅统计非default、非static、非object继承的方法；不加该注解仍可为函数式接口，但加注解提供主动防护。
Java 中的 @FunctionalInterface 注解本身不“主动限制”抽象方法数量，而是由编译器在编译时强制校验：只要接口被该注解标记，编译器就会检查它是否有且仅有一个未被实现的抽象方法。不符合就报错，无法通过编译。
这个机制不是运行时行为，也不靠 JVM 执行时干预，纯粹是编译期约束。
编译器怎么判断“只有一个抽象方法”？
它只统计真正需要被实现的、非默认、非静态、非 Object 继承而来的方法：
- ✅ 计入抽象方法：
void run();、int apply(String s);这类没有方法体、没有default或static修饰的声明。 - ❌ 不计入：
- 默认方法（
default void log() { ... }） - 静态方法（
static String name() { return "X"; }） - 从
Object继承的公共方法（如boolean equals(Object o);、int hashCode();、String toString();），即使没写，也视为已有，不增加抽象方法计数。
- 默认方法（
例如：
@FunctionalInterface
interface Demo {
void doWork(); // ✅ 抽象方法（1个）
default void log() {} // ❌ 默认方法，不计数
static void print() {} // ❌ 静态方法，不计数
@Override boolean equals(Object o); // ❌ 来自 Object，不计数
}
这段代码能编译通过。
但若加上第二个抽象方法：
Java JDK 25 来自 OpenJDK 官方归档，版本为 JDK 25，本条下载地址已指向官方 Windows x64 zip 安装包直链，适合调试旧项目或兼容旧版 Java 运行环境。
@FunctionalInterface
interface BadDemo {
void doWork();
void doMore(); // ❌ 编译报错：Unexpected @FunctionalInterface annotation
}
javac 会明确提示：Multiple non-overriding abstract methods found in interface BadDemo。
不加 @FunctionalInterface 就不算函数式接口吗？
不是。
只要一个接口客观上只有一个抽象方法，哪怕没加注解，它仍是函数式接口，可以用于 lambda 表达式或方法引用：
interface Plain {
String get();
}
// 可以这样用：
Plain p = () -> "hello";
但加了 @FunctionalInterface 后，就多了一层主动防护——防止后续误增抽象方法破坏函数式语义，属于开发约定 + 编译保障双重手段。
常见误判场景与避坑建议
-
接口继承了另一个接口：抽象方法会叠加计算
interface A { void a(); } @FunctionalInterface interface B extends A { void b(); } // ❌ 编译失败：2个抽象方法 重写了 Object 方法但用了
default实现：不影响计数，但若写成抽象声明（如abstract boolean equals(Object o);），就算一个抽象方法
⚠️ 注意：这会覆盖Object的默认语义，一般不推荐。泛型接口、类型参数不影响判断：
Function<t r></t>仍是函数式接口，因为R apply(T t)是它唯一的抽象方法。IDE 和 javac 行为一致：主流 IDE（IntelliJ、Eclipse）会在编辑时高亮错误，和命令行
javac报错完全同步。
不复杂但容易忽略。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
