springboot解决Long类型值传递给页面时精度丢失的问题!

本文介绍了在SpringBoot项目中,由于Long类型主键在超过16位传递给前端时出现精度丢失的问题,提供了解决方案。包括实现全局转换器(针对SpringBoot不同版本的不同实现方式)以及在Bean主键ID上添加注解来确保在JSON序列化时将其转换为String类型,避免精度问题。同时,文中提到了可能遇到的配置冲突问题,并给出了解决建议。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

最近项目中遇到个问题,主键id用的Long类型,Long类型超过16位时传递给前端丢失精度。

网上搜了下,解决办法有很多,大体分为两种,写个全局转换器和在bean主键id上添加注解,其实解决的本质是将Long类型在序列化json时转为String字符串类型,这样就不存在丢失精度了。

1.全局转换器

springboot2以下的版本写个配置类实现WebMvcConfigurerAdapter重写configureMessageConverters方法。

springboot2及其以上的版本写个配置类实现WebMvcConfigurer重写configureMessageConverters方法(2以上版本WebMvcConfigurerAdapter已经废弃了,不推荐使用)。

代码如下:

   

package com.thecityos.city.indicator.admin.common.config;

import java.math.BigInteger;
import java.util.ArrayList;
import java.util.List;

import org.springframework.context.annotation.Configuration;
import org.springframework.http.MediaType;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

import com.alibaba.fastjson.serializer.SerializeConfig;
import com.alibaba.fastjson.serializer.ToStringSerializer;
import com.alibaba.fastjson.support.config.FastJsonConfig;
import com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter;

/**
 * @title: WebMvcConfig
 * @description: 自定义转换
 * @author:
 * @date 2019-08-03 16:23
 */
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    /**
     * 解决主键Long类型返回给页面时,页面精度丢失的问题,时间格式化返回
     * @param converters
     */
    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter();
        //格式化json数据格式
        FastJsonConfig fastJsonConfig = new FastJsonConfig();
        //序列化时避免精度丢失,转换为字符串
        SerializeConfig serializeConfig = SerializeConfig.globalInstance;
        serializeConfig.put(BigInteger.class, ToStringSerializer.instance);
        serializeConfig.put(Long.class, ToStringSerializer.instance);
        serializeConfig.put(Long.TYPE, ToStringSerializer.instance);
        fastJsonConfig.setSerializeConfig(serializeConfig);
        fastJsonConfig.setDateFormat("yyyy-HH-dd HH:mm:ss");
        fastConverter.setFastJsonConfig(fastJsonConfig);
        List<MediaType> fastMediaTypes = new ArrayList<>();
        fastMediaTypes.add(MediaType.APPLICATION_JSON_UTF8);
        fastMediaTypes.add(MediaType.APPLICATION_JSON);
        fastConverter.setSupportedMediaTypes(fastMediaTypes);
        converters.add(0,fastConverter);
    }

}

当然你要是hold住全场可以自己继承WebMvcConfigurationSupport重写configureMessageConverters,特别注意的是,继承该类后springboot的默认自动配置会失效,需要你自己根据需要配置一些东西。

PS:一些常见的问题,写了后没生效,大概率是虽然添加了转换器进去,但是没在首位或者被后续一些配置挤在了后面,因为springmvc处理时,converters里包含很多转换器,但是它匹配到第一个转换器后就直接使用了,后续转换器无效。

我就遇到了项目里因为引用了

<dependency>
    <groupId>com.github.rkonovalov</groupId>
    <artifactId>json-ignore</artifactId>
    <version>1.0.14</version>
</dependency>

这个是解决controller层想屏蔽或者只返回某些字段的一个注解依赖。

但它有个类FilterRegister实现了WebMvcConfigurer并且重写了extendMessageConverters

如下:

package com.jfilter.components;

import com.jfilter.EnableJsonFilter;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.validation.MessageCodesResolver;
import org.springframework.validation.Validator;
import org.springframework.web.method.support.HandlerMethodArgumentResolver;
import org.springframework.web.method.support.HandlerMethodReturnValueHandler;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.config.annotation.*;

import java.util.List;

/**
 * This class used for register FilterConverter in Spring converter list
 *
 * <p>Class depends from {@link EnableJsonFilter} annotation
 */
@Configuration
public class FilterRegister implements WebMvcConfigurer {
    private FilterConfiguration filterConfiguration;

    @Autowired
    public FilterRegister(FilterConfiguration filterConfiguration) {
        this.filterConfiguration = filterConfiguration;
    }

    @Override
    public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
        // Do nothing
    }

    @Override
    public void configurePathMatch(PathMatchConfigurer configurer) {
        // Do nothing
    }

    @Override
    public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {
        // Do nothing
    }

    @Override
    public void configureAsyncSupport(AsyncSupportConfigurer configurer) {
        // Do nothing
    }

    @Override
    public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
        // Do nothing
    }

    @Override
    public void addFormatters(FormatterRegistry registry) {
        // Do nothing
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // Do nothing
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // Do nothing
    }

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        // Do nothing
    }

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        // Do nothing
    }

    @Override
    public void configureViewResolvers(ViewResolverRegistry registry) {
        // Do nothing
    }

    @Override
    public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {
        // Do nothing
    }

    @Override
    public void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers) {
        // Do nothing
    }

    /**
     * Add converter if filtration is enabled
     *
     * @param converters list of {@link HttpMessageConverter}
     */
    @Override
    public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {
        if (filterConfiguration.isEnabled())
            converters.add(0, new FilterConverter(filterConfiguration));
    }

    @Override
    public void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers) {
        // Do nothing
    }

    @Override
    public void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers) {
        // Do nothing
    }

    @Override
    public Validator getValidator() {
        return null;
    }

    @Override
    public MessageCodesResolver getMessageCodesResolver() {
        return null;
    }
}

这就导致了,我自定义的那个配置类解决Long类型丢失的转换器被挤在了后面,所以没有生效,真是醉了,后面研究了一天还是没有啥好的解决办法,除非不用上面那个依赖吧,后续空了再研究。

目前的解决办法时,在实体bean的Long类型字段上加

/**
 * 主键
 */
@JsonSerialize(using = ToStringSerializer.class)
private Long id;
/**
 * 创建时间
 */
@JsonFormat(pattern="yyyy-MM-dd HH:mm:ss",timezone="GMT+8")
private Date createTime;

 

 

 

<think>好的,用户想知道如何在Apifox中Long类型的数据。首先,我需要回忆一下Apifox的基本用法,特别是参数递的部分。根据引用内容,用户之前提到过Apifox替代YApi的情况,可能对接口文档的导入和参数设置有一定了解。 首先,Long类型在API开发中通常用于大整数,比如数据库的主键ID。在Apifox中参数,常见的方式有Query参数、Path参数、Body参数(JSON/Form-data)和Header参数。需要分别说明同场景下的设置方法。 对于Query参数,用户可能在接口的Query部分添加参数,选择类型为number,然后格式选int64,这样生成的示例值会是长整。但要注意,虽然Apifox的UI里可能显示为number,但实际应该以字符串形式递,避免精度丢失,尤其是在处理JavaScript环境的限制。 Path参数的话,类似Query参数,同样需要设置类型为number,格式int64,但要注意路径参数必须是字符串,所以可能需要将Long值转换为字符串递,并在后端进行转换。 Body参数如果是JSON格式,应该在定义Schema指定类型为integer,format为int64。这样生成的示例数据会正确显示长整数值。使用JSON Schema的规范来确保数据类型的正确性。 另外,用户可能需要处理前端Long类型精度丢失问题,比如JavaScript无法精确处理超过53位的整数。这候建议在后端用字符串接收,或者在Apifox中将Long值作为字符串递,并在后端转换。这点需要提醒用户注意,避免实际开发中的问题。 测试的候,可以通过预执行脚本生成Long类型的测试数据,比如Date.now(),但要注意范围是否合适。同,Mock数据可能需要配置规则生成Long类型的值,比如@integer(1000000000, 9999999999)。 总结下来,步骤应该是分场景说明如何设置参数类型和格式,强调使用int64格式,并提醒潜在的精度问题解决方案。需要确保用户理解参数位置(Query、Path、Body)的设置方法,以及前后端协作需要注意的事项。</think>在Apifox中Long类型数据需根据参数位置采用同设置方式,以下是具体实现方法: ### 一、Query参数递 1. 在接口编辑页的`Query`参数栏 2. 添加参数后选择`类型`为`number` 3. 设置`format`为`int64` ```json 示例值:1689576123456 ``` *注意:实际建议使用字符串格式避免精度丢失[^2]* ### 二、Path参数递 1. 在路径参数定义处设置参数类型 2. 选择`Schema`类型为`integer` 3. 设置`format`为`int64` ```javascript // 路径示例 /api/user/${userId} // 实际调用需转为字符串递 ``` ### 三、Body参数递(JSON) 1. 在`Body`选项卡选择`JSON`类型 2. 定义字段Schema指定: ```json { "id": { "type": "integer", "format": "int64" } } ``` *建议值范围:-9223372036854775808 到 9223372036854775807* ### 四、特殊场景处理 1. **精度丢失预防**:前端JS建议使用字符串格式 ```javascript // 请求示例 { "bigintValue": "7689345678923456789" } ``` 2. **后端接收验证**:SpringBoot需使用`@RequestParam`或`@RequestBody`接收 ### 五、测试数据生成 1. 使用预执行脚本生成Long值: ```javascript pm.request.body.raw = JSON.stringify({ timestamp: Date.now() }); ``` 2. Mock规则设置: ```json "id": { "mock": "@integer(1000000000,9999999999)" } ```
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值