Swagger UI在C#中错误舍入大Decimal值问题排查

原因：确实和JS的数值精度限制有关 #

JavaScript的Number类型是双精度浮点数，最大安全整数为2^53 - 1（即9007199254740991）。你存储的数值999999999999999423.999远大于这个阈值，Swagger UI基于JS渲染，解析时会自动将超出安全范围的数值近似处理，导致末尾精度丢失，显示为999999999999999400。

排查步骤 #

• 确认后端返回的JSON是否正确：用Postman、curl直接调用接口，查看返回的原始JSON字符串。如果原始JSON里的数值是完整的999999999999999423.999，说明问题出在Swagger UI的JS解析环节；如果原始JSON就已经丢失精度，那要排查后端序列化配置。
• 检查后端序列化配置有效性：虽然你设置了FloatParseHandling = Decimal，但要确认该配置是否全局生效。比如有没有局部属性用[JsonConverter]指定了其他转换器，或者Startup/Program.cs中的配置代码是否被正确加载（比如有没有被其他配置覆盖）。
• 验证Swagger UI的渲染差异：在Swagger UI界面中，切换到“原始响应”视图，对比渲染后的数值和原始JSON的差异，确认是渲染环节导致的精度丢失。

修复方案 #

方案1：将decimal序列化为字符串返回（推荐） #

让后端把大数值以字符串形式返回，JS处理字符串不会丢失精度，同时也能兼容其他客户端的解析需求。

• 局部属性配置：在对应的decimal属性上添加转换器：

[JsonConverter(typeof(StringConverter))]
public decimal YourBigNumber { get; set; }

• 全局配置（Newtonsoft.Json）：如果多个属性需要处理，可全局配置decimal序列化为字符串：

services.AddControllers()
    .AddNewtonsoftJson(options =>
    {
        // 自定义decimal转字符串转换器
        options.SerializerSettings.Converters.Add(new DecimalToStringConverter());
    });

// 自定义转换器实现
public class DecimalToStringConverter : JsonConverter<decimal>
{
    public override decimal ReadJson(JsonReader reader, Type objectType, decimal existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        return decimal.Parse(reader.Value.ToString(), CultureInfo.InvariantCulture);
    }

    public override void WriteJson(JsonWriter writer, decimal value, JsonSerializer serializer)
    {
        writer.WriteValue(value.ToString(CultureInfo.InvariantCulture));
    }
}

方案2：修改Swagger UI的渲染逻辑 #

如果不想修改后端返回格式，可以自定义Swagger UI的JS脚本，让它识别超出JS安全整数范围的数值，直接显示原始字符串。这种方式需要修改Swagger UI的静态资源或注入自定义脚本，步骤相对繁琐，适合不能修改后端的场景。

方案3：排查中间件是否篡改响应 #

检查项目中是否有压缩、格式化类的中间件，确认它们没有对JSON数值做截断或近似处理。比如某些响应压缩中间件可能会意外修改数值格式，需要调整中间件配置。

内容的提问来源于stack exchange，提问作者Katarina