@FunctionalInterface注解用于标记函数式接口，确保其有且仅有一个抽象方法，从而支持Lambda表达式；它非必需但能触发编译器检查，提升健壮性与可维护性。
Java 中使用 @FunctionalInterface 注解，是为了让编译器帮你确认这个接口是否满足函数式接口的定义——即**有且仅有一个抽象方法**（不包括默认方法、静态方法和 Object 类继承的方法）。它不是必需的，但加上后能提前暴露错误，提升代码健壮性。
什么是函数式接口？
函数式接口是只声明了一个抽象方法的接口，比如 Runnable、Comparator、Function<t></t>。它们的核心价值在于支持 Lambda 表达式和方法引用。JDK 8 引入 @FunctionalInterface 作为标记注解，本身不改变行为，但触发编译器检查：
- 接口中必须有且仅有一个抽象方法；
- 若存在两个或以上抽象方法，加了该注解会直接编译失败；
- 允许有任意数量的默认方法（
default）和静态方法； - 重写
Object的方法（如toString()、equals()）不计入抽象方法计数。
怎么正确使用 @FunctionalInterface
在自定义接口上添加该注解即可，位置在 interface 声明前：
@FunctionalInterface
public interface Calculator {
int apply(int a, int b); // 唯一抽象方法
default int add(int a, int b) {
return a + b;
}
static boolean isValid(int x) {
return x > 0;
}
}
这样写是合法的。但如果多加一个抽象方法：
立即学习“Java免费学习笔记（深入）”；
@FunctionalInterface
public interface Calculator {
int apply(int a, int b);
int multiply(int a, int b); // ❌ 编译报错：Unexpected @FunctionalInterface annotation
编译器会明确提示违反函数式接口约束。
常见误用与注意事项
注意以下几点避免踩坑：
- 不加
@FunctionalInterface也能当函数式接口用（只要满足“一个抽象方法”），但失去编译期保护； - 继承已有函数式接口时，子接口也需满足“一个抽象方法”，否则即使加了注解也会编译失败；
- 如果接口继承了多个父接口，要确保最终所有非默认/非静态的抽象方法合并后仍只有 1 个；
- IDE（如 IntelliJ）通常会在你写错时高亮提醒，但依赖编译器检查更可靠。
为什么推荐加上这个注解？
它本质是一种契约声明：
- 告诉其他开发者：“这个接口设计初衷就是用于 Lambda”；
- 防止后续维护中不小心添加新抽象方法，破坏函数式语义；
- 配合 IDE 和构建工具（如 Maven 编译），实现早期问题拦截；
- 对团队协作和代码可读性有实际帮助，成本几乎为零。
