@functionalinterface 是 java 特有注解，不能在 javascript 中使用；它用于标记仅含一个抽象方法的接口以支持 lambda 表达式，js 无接口概念且函数本身即一等公民。
@FunctionalInterface 是 Java 的注解，**不能在 JavaScript 中使用**。
JavaScript 本身没有接口（interface）概念，更没有 @FunctionalInterface 这样的语法或运行时约束机制。这个注解只存在于 Java 语言中，用于标记**有且仅有一个抽象方法的接口**，以便支持 Lambda 表达式和方法引用 —— 它是 Java 编译器层面的检查工具，对 JavaScript 完全无效。
为什么你会在 JS 混合开发中看到它？
常见于以下场景：
-
Android 原生模块（Java/Kotlin）提供给 JS 调用：比如 React Native 或 Flutter 插件中，Java 端定义了一个回调接口，用
@FunctionalInterface标记，再通过桥接暴露给 JS；JS 端只是传函数，不感知该注解。 - 跨语言通信约定文档或类型提示：团队可能在注释或 TypeScript 类型定义里写 “对应 Java 的 @FunctionalInterface”，仅作语义说明，非实际执行。
- 混淆了 Java 和 JS 的开发边界：误以为 JS 支持类似 Java 的函数式接口语法（实际 JS 的函数本身就是一等公民，无需额外接口包装）。
JavaScript 中“函数式接口”的等价实践
JS 不需要接口约束，但可通过以下方式实现类似意图：
-
明确函数签名（推荐）：用 JSDoc 注释或 TypeScript 类型声明描述参数、返回值和用途。例如：
/** @param {string} url @param {(data: any) => void} onSuccess */<br>function fetchData(url, onSuccess) { ... } -
高阶函数封装：把行为抽象为可组合的函数，如
map、filter、throttle，天然符合单一职责。 -
TypeScript 接口/类型别名：虽非运行时约束，但能静态校验。例如：
type DataHandler = (result: Response) => void;
此时传入的函数必须匹配该签名，否则 TS 编译报错。
混合开发中正确协作的关键点
当 JS 与 Java（如 Android 模块）协同时：
- Java 端用
@FunctionalInterface定义回调接口（如OnResultListener），并在桥接层接收 JS 传来的函数，将其包装为该接口实例。 - JS 端只需按约定传一个普通函数，例如：
nativeModule.doSomething('abc', (res) => console.log(res)); - 桥接代码（如 React Native 的
WritableMap/Promise或自定义事件）负责将 JS 函数映射到 Java 接口实现，@FunctionalInterface在此环节起编译期保障作用 —— 但 JS 侧完全无感知。
不复杂但容易忽略：JS 和 Java 各自有其范式，强行套用对方的概念反而增加理解成本。用好各自的语言特性，明确分层职责，才是混合开发的高效之道。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
