Java抽象类不能直接映射为GraphQL Interface，必须用Java接口显式定义契约，再由抽象类实现该接口，子类继承抽象类并在Schema中手动注册Interface及possibleTypes。
Java 中的抽象类不能直接映射为 GraphQL 的 Interface 类型，因为 GraphQL Interface 是一种纯契约定义（只声明字段和类型，不包含实现），而 Java 抽象类既可声明抽象方法，也可包含具体字段和实现逻辑。GraphQL Java（如 graphql-java 库）本身不自动将 Java 抽象类“翻译”成 GraphQL Interface；你需要**显式建模**：用 Java 接口（interface）对应 GraphQL Interface，再让抽象类或普通类实现该接口，并在 Schema 构建时手动注册。
用 Java 接口定义 GraphQL Interface 契约
GraphQL Interface 必须由 Java 接口表示，这是强制约定。例如：
public interface NamedEntity {
String getName();
}
这个 NamedEntity 接口对应 GraphQL 中的：
interface NamedEntity {
name: String!
}
它不包含任何实现，只声明行为契约，符合 GraphQL Interface 的语义。
立即学习“Java免费学习笔记（深入）”；
让抽象类实现该 Java 接口
抽象类可以实现上述接口，并提供部分通用实现：
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
- 抽象类本身不直接注册为 GraphQL 类型，但它是具体子类的基类
- 子类（如
User、Product）继承抽象类并实现接口方法 - 所有子类必须满足
NamedEntity契约（即有name字段）
示例：
public abstract class BaseEntity implements NamedEntity {
protected String name;
public String getName() { return name; }
}
public class User extends BaseEntity {
private String email;
// getter/setter...
}
public class Product extends BaseEntity {
private BigDecimal price;
// getter/setter...
}
在 Schema 中注册 Interface 和具体类型
使用 graphql-java 时，需手动构建 InterfaceType 并声明其可能的实现类型（possibleTypes）：
- 通过
InterfaceType.newInterface()定义 GraphQL Interface - 调用
.typeResolver(...)提供运行时类型识别逻辑（根据 Java 实例返回对应的 GraphQL 对象类型名） - 确保每个具体子类（
User、Product）都作为ObjectType注册进 Schema
关键点：typeResolver 必须能区分 User 和 Product 实例，返回 "User" 或 "Product" 字符串，否则查询会失败。
避免常见误区
不要尝试把抽象类直接传给 RuntimeWiring 或 TypeDefinitionRegistry 当作 Interface 使用——这会导致 Schema 构建失败或运行时异常。
也不建议用 Lombok @Data 或 Jackson 注解“绕过”接口定义，因为 GraphQL 的 Interface 要求明确的类型关系和字段一致性，依赖注解自动推导无法保证 __typename 和字段对齐。
如果抽象类含非接口声明的字段（如 id、createdAt），这些字段要显式添加到所有实现该 Interface 的 GraphQL Object Type 中，或通过 Java 接口方法暴露（如 getId()），再在 Interface 定义里声明对应字段。
