网站备案管理系统湖南做网站找磐石网络一流

张

张建站

2026/4/8 16:37:23

10分钟阅读

网站备案管理系统,湖南做网站找磐石网络一流,网络营销是什么部门,律师事务所网站建设Jackson全局配置指南#xff1a;一劳永逸解决前端Long精度问题#xff08;SpringBoot2.7#xff09; 如果你在金融交易、物联网设备管理或者任何涉及大数字ID的系统中工作过#xff0c;大概率遇到过那个让人头疼的问题#xff1a;一个19位的订单号或者设备ID#xff0c;从…Jackson全局配置指南一劳永逸解决前端Long精度问题SpringBoot2.7如果你在金融交易、物联网设备管理或者任何涉及大数字ID的系统中工作过大概率遇到过那个让人头疼的问题一个19位的订单号或者设备ID从后端传到前端最后三位数字莫名其妙地变成了0。这不仅仅是数据展示错误在极端情况下它可能导致订单匹配失败、设备指令发错对象甚至引发资金对账的混乱。问题的根源在于JavaScript的Number类型在处理超过2^53的整数时存在精度限制而Java的Long类型最大值远超这个范围。过去我们可能会在每一个实体类的Long字段上添加JsonFormat(shape JsonFormat.Shape.STRING)这就像给一栋大楼的每一扇窗户都贴上防爆膜费时费力还容易遗漏。今天我们要聊的是一种更优雅、更彻底的解决方案通过深度定制Jackson的ObjectMapper实现一套全局的、模块化的序列化规则。这不仅仅是解决Long精度丢失更是构建一套健壮、统一的数据传输契约让LocalDateTime等时间类型也能遵循我们定义的格式告别杂乱无章的日期字符串。1. 理解问题本质为什么Long类型在前端会“失真”要解决问题首先得看清对手。精度丢失并非Spring Boot或Jackson的bug而是不同语言运行时环境之间的固有差异。在Java的世界里Long是一个64位的有符号整数其取值范围从-9,223,372,036,854,775,808到9,223,372,036,854,775,807。这个范围足够容纳像雪花算法生成的19位ID最大值约为9.22e18。然而当这个Long值被序列化为JSON数字例如{id: 1456789012345678901}时问题就开始了。前端JavaScript或TypeScript使用Number类型来表示所有数字它遵循IEEE 754双精度浮点数标准。这种格式用64位存储一个数字但其中一部分位用于表示指数实际用于表示整数的有效位尾数只有53位。这意味着JavaScript能够“安全”表示的整数范围是-2^53 1到2^53 - 1即-9,007,199,254,740,991到9,007,199,254,740,991大约16位十进制数。注意所谓“安全整数”是指在该范围内的整数其双精度浮点数表示是精确的可以用于精确的整数运算和比较。超出这个范围虽然也能表示但可能会被舍入到最接近的可表示值。当后端传出一个19位的Long值例如1456789012345678901它已经超出了JavaScript的安全整数范围。浏览器或Node.js在解析这个JSON时会尝试将这个数字放入一个Number变量中导致精度丢失最后三位可能变为000或999。两种常见解决方案的对比方案实现方式优点缺点适用场景JsonFormat注解在实体类的字段上添加JsonFormat(shape Shape.STRING)1. 精准控制单个字段2. 简单直观无需全局配置1.重复劳动每个Long字段都需添加2.易遗漏新增字段容易忘记3.侵入性强污染实体类代码遗留系统微调、仅个别字段需要特殊处理的场景自定义ObjectMapper创建继承ObjectMapper的配置类注册自定义序列化模块1.一劳永逸全局生效2.集中管理所有规则一目了然3.非侵入性实体类保持纯净4.高扩展性易于添加其他类型规则1. 初始配置稍复杂2. 需要理解Jackson模块化机制新建项目、重构项目、对数据格式有统一要求的企业级应用显然对于追求工程效率和系统一致性的团队自定义ObjectMapper是更优的选择。它不仅解决了Long精度问题还为统一处理日期、时间、大整数等类型打开了大门。2. 深入Jackson核心模块化设计与ObjectMapperJackson不是一个黑盒而是一个高度可扩展的库。它的强大之处在于其模块化架构。理解这一点是我们进行高级定制的基础。ObjectMapper是Jackson进行序列化Java对象 - JSON和反序列化JSON - Java对象的核心引擎。你可以把它想象成一个配备了各种工具的工厂流水线。默认情况下这条流水线能处理大多数标准Java类型。但当我们有特殊需求时比如把Long当成String输出就需要为这条流水线安装新的“加工模具”——这就是Module。一个Module在Jackson中通常指SimpleModule可以同时注册多个序列化器JsonSerializer和反序列化器JsonDeserializer。序列化器负责将Java对象如Long转换为JSON节点如String类型的值。反序列化器负责将JSON节点转换回Java对象。Spring Boot在自动配置时会创建一个ObjectMapperBean供整个应用使用。我们的目标就是提供一个自定义的ObjectMapperBean来替换它并在其中注册我们自己的模块。让我们先看一个最精简的、只解决Long精度问题的配置类import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.module.SimpleModule; import com.fasterxml.jackson.databind.ser.std.ToStringSerializer; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary; Configuration public class JacksonConfig { Bean Primary // 确保此Bean被优先使用 public ObjectMapper objectMapper() { ObjectMapper objectMapper new ObjectMapper(); SimpleModule module new SimpleModule(); // 关键配置将Long和long类型序列化为String module.addSerializer(Long.class, ToStringSerializer.instance); module.addSerializer(Long.TYPE, ToStringSerializer.instance); // 处理基本类型long objectMapper.registerModule(module); return objectMapper; } }这段代码创建了一个新的ObjectMapper并注册了一个自定义模块。模块里告诉Jackson“遇到Long类或者基本类型long请使用ToStringSerializer这个现成的工具把它变成字符串。”Primary注解确保当Spring容器中存在多个ObjectMapperBean时优先使用我们定义的这一个。现在任何被这个ObjectMapper处理的Long字段在输出JSON时都会自动加上双引号变成字符串类型。前端拿到的是{id: 1456789012345678901}精度得以完美保留。3. 构建企业级配置兼容时间类型与更多细节只处理Long是远远不够的。一个成熟的后端服务还需要统一处理日期时间格式。你是否受够了接口返回的LocalDateTime有时是时间戳有时是2023-10-01T12:00:00这种ISO格式有时又是其他乱七八糟的格式是时候终结这种混乱了。我们将创建一个继承自ObjectMapper的专用配置类它更清晰也更容易管理复杂的配置。package com.yourproject.config; import com.fasterxml.jackson.databind.DeserializationFeature; import com.fasterxml.jackson.databind.ObjectMapper; import com.fasterxml.jackson.databind.module.SimpleModule; import com.fasterxml.jackson.databind.ser.std.ToStringSerializer; import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule; import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer; import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer; import com.fasterxml.jackson.datatype.jsr310.deser.LocalTimeDeserializer; import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateSerializer; import com.fasterxml.jackson.datatype.jsr310.ser.LocalDateTimeSerializer; import com.fasterxml.jackson.datatype.jsr310.ser.LocalTimeSerializer; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import org.springframework.context.annotation.Primary; import java.math.BigInteger; import java.time.LocalDate; import java.time.LocalDateTime; import java.time.LocalTime; import java.time.format.DateTimeFormatter; Configuration public class JacksonConfig { // 定义全局统一的日期时间格式 private static final String DATE_FORMAT yyyy-MM-dd; private static final String DATE_TIME_FORMAT yyyy-MM-dd HH:mm:ss; private static final String TIME_FORMAT HH:mm:ss; Bean Primary public ObjectMapper objectMapper() { ObjectMapper mapper new CustomObjectMapper(); // 这里可以进行其他全局配置例如设置属性命名策略等 // mapper.setPropertyNamingStrategy(PropertyNamingStrategies.SNAKE_CASE); return mapper; } /** * 自定义的ObjectMapper实现类。 * 将配置逻辑封装在类内部使外部配置类更简洁。 */ public static class CustomObjectMapper extends ObjectMapper { public CustomObjectMapper() { super(); // 1. 基础反序列化配置忽略JSON中存在的未知属性 this.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); // 2. 创建并注册自定义SimpleModule处理Long/BigInteger和Java 8时间类型 SimpleModule customModule new SimpleModule(); // 2.1 处理数字类型精度丢失序列化为String customModule.addSerializer(Long.class, ToStringSerializer.instance); customModule.addSerializer(Long.TYPE, ToStringSerializer.instance); customModule.addSerializer(BigInteger.class, ToStringSerializer.instance); // 2.2 处理Java 8时间类型统一格式 DateTimeFormatter dateFormatter DateTimeFormatter.ofPattern(DATE_FORMAT); DateTimeFormatter dateTimeFormatter DateTimeFormatter.ofPattern(DATE_TIME_FORMAT); DateTimeFormatter timeFormatter DateTimeFormatter.ofPattern(TIME_FORMAT); // 序列化器 customModule.addSerializer(LocalDateTime.class, new LocalDateTimeSerializer(dateTimeFormatter)); customModule.addSerializer(LocalDate.class, new LocalDateSerializer(dateFormatter)); customModule.addSerializer(LocalTime.class, new LocalTimeSerializer(timeFormatter)); // 反序列化器 customModule.addDeserializer(LocalDateTime.class, new LocalDateTimeDeserializer(dateTimeFormatter)); customModule.addDeserializer(LocalDate.class, new LocalDateDeserializer(dateFormatter)); customModule.addDeserializer(LocalTime.class, new LocalTimeDeserializer(timeFormatter)); this.registerModule(customModule); // 3. 注册标准的JavaTimeModule可选但建议保留以支持更全面的时间类型功能 // 注意如果自定义模块的规则与标准模块冲突后注册的模块规则可能会覆盖先注册的。 // 因为我们已经为LocalDateTime等注册了具体的序列化/反序列化器所以它们会生效。 this.registerModule(new JavaTimeModule()); // 禁用默认的日期序列化为时间戳的行为 this.disable(com.fasterxml.jackson.databind.SerializationFeature.WRITE_DATES_AS_TIMESTAMPS); } } }这个配置类做了以下几件关键事情精度问题根治将Long、long、BigInteger全部序列化为字符串。时间格式统一为LocalDateTime、LocalDate、LocalTime指定了统一的序列化和反序列化格式例如2023-10-01 14:30:00确保前后端交互格式一致。容错性增强配置了FAIL_ON_UNKNOWN_PROPERTIES false这意味着前端多传了一些字段也不会导致反序列化失败提高了接口的健壮性。模块化清晰将相关配置封装在独立的CustomObjectMapper类中结构清晰易于测试和维护。提示关于JavaTimeModule。我们既注册了自定义的SimpleModule也注册了标准的JavaTimeModule。这是因为JavaTimeModule提供了对Duration、Period等更多时间类型的支持。自定义模块中针对特定类型的序列化器具有更高优先级因此LocalDateTime等会使用我们定义的格式而其他时间类型则回退到JavaTimeModule的默认行为通常是ISO格式。这是一种兼顾定制与全面的做法。4. 实战进阶应对复杂场景与个性化需求上面的配置已经能解决90%的问题。但在实际企业应用中我们可能会遇到更复杂的场景。场景一不同接口需要不同的序列化策略比如管理后台的接口希望看到完整的、格式统一的数据而对移动端的API为了节省流量可能希望时间用时间戳Long类型保持数字。强行全局统一可能不满足所有需求。解决方案是使用多个ObjectMapper实例。你可以为不同的场景定义不同的配置类或者使用Qualifier注解来按名称注入特定的ObjectMapper。Configuration public class MultiMapperConfig { // 默认的、全局统一的Mapper用于大多数内部接口 Bean Primary public ObjectMapper defaultObjectMapper() { ObjectMapper mapper new ObjectMapper(); // ... 应用上述全局配置 return mapper; } // 针对移动端API的轻量级Mapper Bean(mobileObjectMapper) public ObjectMapper mobileObjectMapper() { ObjectMapper mapper new ObjectMapper(); // 不将Long转为String保持为数字移动端SDK可能已处理大数 // 时间使用时间戳 mapper.registerModule(new JavaTimeModule()); mapper.configure(SerializationFeature.WRITE_DATES_AS_TIMESTAMPS, true); // 忽略未知属性等基础配置 mapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false); return mapper; } } // 在Service或Controller中按需注入 RestController RequestMapping(/api/mobile) public class MobileController { Autowired Qualifier(mobileObjectMapper) // 指定注入名为mobileObjectMapper的Bean private ObjectMapper mobileObjectMapper; GetMapping(/data) public String getMobileData() throws JsonProcessingException { MyData data fetchData(); // 使用移动端专用的Mapper进行序列化 return mobileObjectMapper.writeValueAsString(data); } }场景二处理泛型集合中的Long类型我们的全局配置对ListLong、MapString, Long这样的泛型集合同样有效。因为Jackson在序列化集合内的每个元素时都会调用对应类型的序列化器。场景三配置的优先级与覆盖关系需要了解Spring Boot中Jackson配置的生效顺序application.properties/yml中的spring.jackson.*属性最低优先级用于简单设置。Jackson2ObjectMapperBuilderCustomizerBean可以进行编程式配置。自定义的ObjectMapperBean如果被Primary标记则具有最高优先级。我们的自定义ObjectMapperBean属于第3种会覆盖前两种方式的配置。这确保了我们的规则是最终生效的。5. 测试与验证确保配置生效配置写完了怎么知道它真的起作用了写个简单的测试接口验证一下是最直接的方法。import com.fasterxml.jackson.core.JsonProcessingException; import com.fasterxml.jackson.databind.ObjectMapper; import lombok.Data; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; import java.time.LocalDateTime; import java.util.Arrays; import java.util.List; RestController public class TestController { Autowired private ObjectMapper objectMapper; // 这里会自动注入我们自定义的ObjectMapper Data static class TestData { private Long snowflakeId 1456789012345678901L; private long primitiveLong 987654321012345678L; private LocalDateTime createTime LocalDateTime.now(); private ListLong idList Arrays.asList(1001L, 1002L, 1000000000000000000L); } GetMapping(/test/json) public String testJsonSerialization() throws JsonProcessingException { TestData data new TestData(); String jsonString objectMapper.writeValueAsString(data); // 直接返回序列化后的JSON字符串方便在浏览器查看 return jsonString; } }启动应用访问/test/json你应该会看到类似下面的输出{ snowflakeId: 1456789012345678901, primitiveLong: 987654321012345678, createTime: 2023-10-27 15:30:45, idList: [1001, 1002, 1000000000000000000] }注意观察所有的Long和long值都被加上了双引号变成了字符串。LocalDateTime的格式是我们指定的yyyy-MM-dd HH:mm:ss。列表idList中的Long值也全部被正确转换。这个结果清晰地证明了我们的全局配置正在按预期工作。前端开发者现在可以放心地使用这些ID进行字符串比较或展示再也不用担心精度问题了。最后记得在团队内部进行知识共享将这套配置作为项目的基础设施之一。对于新启动的Spring Boot 2.7项目直接引入这个配置类就能从根本上杜绝Long精度丢失和日期格式混乱这两个高频问题把精力更多地投入到业务逻辑开发上。