全局处理Long类型字段返回前端精度丢失

最新推荐文章于 2025-08-28 19:53:58 发布

原创最新推荐文章于 2025-08-28 19:53:58 发布 · 1.5k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#前端 #java #mybatis

Springboot 同时被 2 个专栏收录

7 篇文章

订阅专栏

前端

3 篇文章

订阅专栏

在后端使用MybatisPlus时，主键策略为@TableId(type=IdType.ASSIGN_ID)生成19位的雪花ID，当以Long类型返回给前端时，由于number类型最多只能精确到16位，导致精度丢失。解决方法包括在字段上添加@JsonFormat(shape=JsonFormat.Shape.STRING)注解或全局配置Jackson序列化，确保Long类型转换为字符串以避免精度问题。

项目场景：

后端返回一个列表数据到前端，其中有部分字段类型后端定义的是Long类型并且是用雪花算法生成的，从响应数据中发现返回的值与数据库的不一致，丢失了精度

问题描述

后端使用MybatisPlus时，主键字段的主键策略用是@TableId(type = IdType.ASSIGN_ID)，意味着主键会生成一个长度为19位的值，后端用Long类型接收没问题，而前端number能接收的最大长度为16位，最大值（9007 1992 5474 0992），此时后端雪花ID返回到前端就出现了丢失精度的情况。
如下图所示：

/**任务主键*/
@ApiModelProperty(value = "任务主键")
@TableId(type = IdType.ASSIGN_ID)
private Long taskId;

解决方案：

有两种最常见的解决办法：
第一种是局部针对某个字段处理，这种是极其不推荐的，到处都得加；
第二种是全局配置，处理Long类型字段，推荐第二种

1、在字段上加注解 @JsonFormat(shape = JsonFormat.Shape.STRING)

/**任务主键*/
@ApiModelProperty(value = "任务主键")
@JsonFormat(shape = JsonFormat.Shape.STRING)
private Long taskId;

2、增加全局配置类，实现WebMvcConfigurer接口，重写configureMessageConverters方法

@Configuration
public class WebMvcConfiguration implements WebMvcConfigurer {

	/**
     * 添加Long转json精度丢失的配置
     * @Return: void
     */
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        MappingJackson2HttpMessageConverter jackson2HttpMessageConverter = new MappingJackson2HttpMessageConverter();
        ObjectMapper objectMapper = new ObjectMapper();
        SimpleModule simpleModule = new SimpleModule();
        simpleModule.addSerializer(Long.class, ToStringSerializer.instance);
        simpleModule.addSerializer(Long.TYPE, ToStringSerializer.instance);
        objectMapper.registerModule(simpleModule);
        jackson2HttpMessageConverter.setObjectMapper(objectMapper);
        converters.add(jackson2HttpMessageConverter);
    }
}