本文介绍一种简洁、灵活且无需硬编码字段名的方式，将任意 java 对象自动序列化为 key=value&key2=value2 格式的字符串，适用于表单提交、日志记录或轻量级参数拼接等场景。
在 Java 开发中，常需将 POJO（Plain Old Java Object）转换为类似 HTTP 查询参数的键值对字符串（如 name=John&age=30&address=12st%20NW%20Street），但又不希望引入 URL 编码、不依赖 JSON 格式，同时还要避免手动维护字段名或使用反射编写冗长逻辑。此时，借助 Jackson 的类型转换能力是一种优雅且健壮的解决方案。
✅ 推荐方案：Jackson + Stream 流式拼接
假设你已有一个标准 Java Bean：
public class Person {
private String name;
private int age;
private String address;
private String city;
// 构造函数、getter/setter 省略（必须提供 getter！）
}只需以下几行代码即可完成转换：
ObjectMapper mapper = new ObjectMapper();
Map<String, Object> map = mapper.convertValue(person, Map.class);
String queryString = map.entrySet().stream()
.map(entry -> entry.getKey() + "=" + entry.getValue())
.collect(Collectors.joining("&"));? 说明：mapper.convertValue(..., Map.class) 会自动调用所有 public getter 方法，将对象属性名作为 key、返回值作为 value，构建一个 LinkedHashMap（保持字段声明顺序）。该方式天然支持嵌套对象（默认转为 toString()）、集合、甚至 null 值（输出为 key=null），无需额外配置。
⚠️ 注意事项
- Getter 是必需的：Jackson 依赖 JavaBean 规范，确保每个字段都有对应 public getter（如 getName()），否则字段会被忽略；
- 不处理 URL 编码：本方案输出的是原始值拼接，若需兼容 URL 传输（如含空格、&、= 等），请显式使用 URLEncoder.encode(value, StandardCharsets.UTF_8) 包裹 value；
- 类型一致性：int/boolean 等基本类型会被自动装箱为 Integer/Boolean，toString() 行为可靠；自定义对象则调用其 toString()，建议重写以保证可读性；
- 性能考量：对于高频调用场景，应将 ObjectMapper 实例设为 static final 单例复用，避免重复创建开销。
? 进阶建议：封装为通用工具方法
为提升复用性，可封装为静态工具：
立即学习“Java免费学习笔记（深入）”；
public class ObjectToQueryString {
private static final ObjectMapper MAPPER = new ObjectMapper();
public static String toQueryString(Object obj) {
if (obj == null) return "";
Map<String, Object> map = MAPPER.convertValue(obj, Map.class);
return map.entrySet().stream()
.map(e -> e.getKey() + "=" + String.valueOf(e.getValue()))
.collect(Collectors.joining("&"));
}
}
// 使用：String s = ObjectToQueryString.toQueryString(person);该方案兼顾灵活性、可维护性与可读性，既规避了反射的复杂性，又比手写 toString() 更具扩展性——当类结构变更时，无需修改序列化逻辑，真正做到“零侵入”。
