Fastjson2中全局BrowserCompatible模式下局部返回number类型的解决方案

在Java开发中，Fastjson2作为一款高性能的JSON处理库，提供了丰富的特性来满足不同场景的需求。其中BrowserCompatible特性是一个常用的配置，它能够确保JSON序列化结果在浏览器环境中安全处理大数字，避免精度丢失问题。

BrowserCompatible特性的作用

当启用BrowserCompatible特性时，Fastjson2会将超过JavaScript安全整数范围(±9007199254740991)的数字自动序列化为字符串形式。这一特性对于前后端交互特别重要，因为JavaScript的Number类型只能安全表示-(2^53-1)到2^53-1之间的整数。

实际开发中的需求冲突

在实际项目中，我们可能会遇到这样的场景：虽然全局启用了BrowserCompatible特性，但某些特定字段由于历史原因或特殊需求，仍然需要保持number类型输出。例如，某些客户端代码可能已经固定处理了这些字段为数字类型，如果突然变为字符串可能会导致兼容性问题。

解决方案实现

Fastjson2提供了灵活的扩展机制，可以通过自定义ObjectWriter来实现特定字段的序列化控制。以下是实现方案的核心代码：

public class IgnoreBrowserCompatibleObjectWriter implements ObjectWriter<BigDecimal> {
    @Override
    public void write(JSONWriter jsonWriter, Object object, Object fieldName, 
                     Type fieldType, long features) {
        if (object instanceof BigDecimal) {
            // 临时禁用BrowserCompatible特性
            jsonWriter.config(JSONWriter.Feature.BrowserCompatible, false);
            // 确保BigDecimal以普通形式输出
            jsonWriter.config(JSONWriter.Feature.WriteBigDecimalAsPlain, true);
            // 写入数值
            jsonWriter.writeDecimal((BigDecimal) object);
            // 恢复BrowserCompatible特性
            jsonWriter.config(JSONWriter.Feature.BrowserCompatible, true);
        } else {
            jsonWriter.writeNull();
        }
    }
}

使用方式

在需要特殊处理的字段上添加@JSONField注解，指定使用自定义的序列化器：

@Data
public class TestDto {
    @JSONField(serializeUsing = IgnoreBrowserCompatibleObjectWriter.class)
    private BigDecimal amount = new BigDecimal("2000000000000000000");
}

实现原理分析

这个解决方案的核心在于：

1. 在序列化特定字段时，临时修改JSONWriter的配置
2. 禁用BrowserCompatible特性，确保当前字段以数字形式输出
3. 序列化完成后立即恢复原有配置，不影响其他字段的处理
4. 整个过程是线程安全的，因为JSONWriter实例是每个序列化请求独立的

注意事项

虽然这种方案在实践中被验证可行，但开发者需要注意：

1. 确保在字段处理完成后恢复全局配置
2. 明确标注哪些字段需要特殊处理，方便后续维护
3. 对于特别大的数值，仍需评估客户端是否能正确处理
4. 在分布式环境下，确保所有服务节点使用相同版本的序列化逻辑

通过这种灵活的配置方式，开发者可以在保持全局兼容性的同时，满足特定场景下的特殊需求，体现了Fastjson2在设计上的高度可扩展性。