Java中实现对象部分字段按条件动态序列化的核心是绕过默认全量机制，主流方案包括：①@JsonView按角色/场景固定过滤；②@JsonInclude配合自定义逻辑动态排除；③SimpleBeanPropertyFilter运行时动态构建序列化器。
Java 中实现对象的部分字段按条件动态序列化，核心思路是**绕过默认全量序列化机制，改用可编程控制的序列化方式**。主流做法有三类：基于 Jackson 的注解+自定义序列化器、运行时动态配置序列化视图（View）、或使用 `@JsonInclude` 配合条件逻辑。下面分场景说明实用方案。
用 @JsonView 实现角色/场景驱动的字段过滤
适合按业务角色（如管理员 vs 普通用户）或接口场景（详情页 vs 列表页）固定筛选字段。
示例：定义视图类：
public class Views {
public static class Public {}
public static class Internal extends Public {}
}
在实体中标注字段：
立即学习“Java免费学习笔记（深入）”；
public class User {
@JsonView(Views.Public.class)
private String username;
@JsonView(Views.Public.class)
private String avatar;
@JsonView(Views.Internal.class)
private String email;
@JsonView(Views.Internal.class)
private String phone;
}
Controller 中指定视图：
Alibabacloud Sdk Client Initialization For Java
下载
在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。
@GetMapping("/user")
public User getUser() {
return user; // 默认只序列化 @JsonView(Views.Public.class) 字段
}
@GetMapping("/user/detail")
@JsonView(Views.Internal.class)
public User getDetail() {
return user; // 序列化 Public + Internal 字段
}
用 @JsonInclude + 自定义判断逻辑动态排除字段
适合字段是否输出取决于运行时值（如非空才输出、满足权限才输出）。
方法一：配合 `@JsonInclude.Include.CUSTOM` 和自定义 `ValueFilter`：
public class NonNullOrAdminFilter implements ValueFilter {
@Override
public boolean serialize(Object value, Object currentObject) {
if (value == null) return false;
if (currentObject instanceof User user) {
return user.hasAdminRole() || value != user.getEmail();
}
return true;
}
}
然后在字段上标注：
@JsonInclude(value = JsonInclude.Include.CUSTOM,
valueFilter = NonNullOrAdminFilter.class)
private String email;
方法二（更轻量）：直接用 `@JsonInclude` 的内置策略 + getter 控制：
public class User {
private String email;
private boolean isAdmin;
@JsonInclude(JsonInclude.Include.NON_NULL)
public String getEmail() {
return isAdmin ? email : null; // 非管理员时强制返回 null，触发跳过
}
}
运行时动态构建序列化器（Jackson SerializerProvider）
适合高度灵活场景，例如前端传入字段白名单，后端按需序列化。
不推荐直接重写整个序列化器，而是利用 `ObjectWriter` 动态配置：
- 用
SimpleBeanPropertyFilter定义包含/排除规则 - 通过
SimpleFilterProvider绑定到类 - 每次请求构造不同的
ObjectWriter
List<String> includeFields = Arrays.asList("username", "avatar");
SimpleBeanPropertyFilter filter = SimpleBeanPropertyFilter.filterOutAllExcept(includeFields);
SimpleFilterProvider filters = new SimpleFilterProvider().addFilter("userFilter", filter);
ObjectWriter writer = mapper.writer(filters);
String json = writer.writeValueAsString(user); // 仅输出指定字段
补充：避免踩坑的关键点
- 字段级注解（如
@JsonIgnore）优先级高于类级@JsonInclude，冲突时以字段为准 -
@JsonView对 getter/setter 也生效，确保视图标注在正确位置 - 动态过滤若涉及权限判断，注意
currentObject在 filter 中可能为 null，需判空 - Spring Boot 中开启视图支持无需额外配置，但需确保 controller 方法返回类型是具体对象而非
ResponseEntity<Object>（否则视图失效）
