Java 中自定义函数式接口如何添加注解检查

必须加@FunctionalInterface注解，它是编译期强制校验开关，确保接口有且仅有一个抽象方法；接口需为interface声明，default和static方法不计入抽象方法数。

直接在接口声明前加上 @FunctionalInterface 注解即可，这是最核心、最有效的检查手段。

必须加 @FunctionalInterface 注解

这个注解不是可选的装饰，而是编译期强制校验开关：

• 一旦加上，编译器会立刻检查：抽象方法是否恰好只有 1 个
• 如果多写一个抽象方法，或删光所有抽象方法，编译直接失败，报错提示明确（如 “Unexpected @FunctionalInterface annotation”）
• 它和 @Override 类似，不改变运行行为，只增强开发阶段的安全性

接口定义本身要满足硬性条件

注解只是“守门员”，前提是接口本身结构合法：

• 必须用 interface 声明，不能是 class 或 abstract class
• 抽象方法只能有且仅有 1 个（即没有方法体、未用 default 或 static 修饰的方法）
• default 方法、static 方法、Object 继承的方法（如 toString()）都不算抽象方法，可任意添加

常见错误写法及修正

加了注解却编译不过？多半是以下情况：

立即学习“Java免费学习笔记（深入）”；

• 接口继承了另一个含抽象方法的接口 → 导致总抽象方法数超过 1 → 改为组合方式或重新设计契约
• 误把 default 方法当成抽象方法删掉 → 结果剩下 0 个抽象方法 → 补回一个抽象方法即可
• 写了两个无实现的普通方法 → 删除其中一个，或把其中一个改为 default

标准写法示例

一个安全、可直接用于 Lambda 的自定义函数式接口：

@FunctionalInterface<br>public interface StringProcessor {<br>    // 唯一抽象方法<br>    String process(String input);<br><br>    // default 方法不影响函数式接口性质<br>    default boolean isEmpty(String s) {<br>        return s == null || s.trim().isEmpty();<br>    }<br><br>    // static 方法也不计入<br>    static String toUpperCase(String s) {<br>        return s != null ? s.toUpperCase() : null;<br>    }<br>}