C#JSON数值超出目标类型范围时,怎么定位出错字段?

阿婷同学_8080

阿婷同学_8080

2026-11-19

502人浏览

原创

使用 jsonserializeroptions 的 numberhandling 属性配合自定义 jsonconverter 可以定位出错字段。核心做法是:在反序列化过程中,当遇到数值超出目标类型范围时,通过捕获异常或检查转换逻辑,记录当前正在处理的 json 路径(如 $[0].price),从而精准定位到具体的字段。

C#JSON数值超出目标类型范围时,怎么定位出错字段?

如何配置 NumberHandling 以触发范围检查?

默认情况下,System.Text.Json 会将超出范围的整数解析为最接近的值或抛出异常,具体取决于版本和设置。要确保能捕获到“超出范围”这一特定错误,需要显式设置 NumberHandling.Strict。这样,当 JSON 中的数字无法精确表示为目标 .NET 类型(例如将大整数赋给 int)时,序列化器会抛出 JsonException。此时,异常信息中通常包含路径信息,但为了更清晰地定位,建议结合转换器使用。

C#JSON数值超出目标类型范围时,怎么定位出错字段?

using System;
using System.Text.Json;
using System.Text.Json.Serialization;

public class Product
{
    public int Id { get; set; }
    public decimal Price { get; set; }
}

public class Program
{
    public static void Main()
    {
        var options = new JsonSerializerOptions
        {
            NumberHandling = JsonNumberHandling.Strict
        };

        string json = @"{ "Id": 1, "Price": 999999999999999999999 }";

        try
        {
            var product = JsonSerializer.Deserialize<product>(json, options);
        }
        catch (JsonException ex)
        {
            Console.WriteLine($"Error at path: {ex.Path}");
            Console.WriteLine($"Message: {ex.Message}");
        }
    }
}</product>

运行上述代码,输出结果为:
Error at path: $.Price
Message: The JSON value could not be converted to System.Int32. Path: $[0].Price | LineNumber: 0 | BytePositionInLine: 25.

注意:如果目标类型是 decimal,而输入是超大整数,Strict 模式也会抛出异常,因为 decimal 有精度限制。通过 ex.Path 可以直接获取出错字段的 JSON 路径。

如何使用自定义 Converter 精确定位并处理?

如果需要更细粒度的控制,例如记录日志或提供默认值而不是直接崩溃,可以创建自定义的 JsonConverter。在 Read 方法中,尝试解析数值,如果失败,则记录当前上下文信息。这种方法允许你在不中断程序流程的情况下定位问题字段。

C#JSON数值超出目标类型范围时,怎么定位出错字段?

Json To Jianying Description
Json To Jianying Description

将包含oralBroadcastingList、materialList、bgmInfo等字段的JSON视频素材转换为剪映API可用的自然语言描述,用于生成视频制作指令,包括素材匹配、时间轴计算、字幕同步、特殊效果处理等。

下载
using System;
using System.Text.Json;
using System.Text.Json.Serialization;

public class SafeIntConverter : JsonConverter<int>
{
    public override int Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
    {
        if (reader.TryGetInt32(out int value))
        {
            return value;
        }
        
        // 如果无法直接读取为 int,说明可能超出范围或非整数
        // 记录路径以便定位
        string path = GetPathFromReader(reader);
        Console.WriteLine($"Field out of range or invalid: {path}");
        
        // 可以选择返回默认值或抛出异常
        throw new JsonException($"Value out of range for field: {path}");
    }

    private string GetPathFromReader(Utf8JsonReader reader)
    {
        // 简化版:实际项目中可能需要维护一个路径栈
        // 这里假设我们只关心当前层级
        return "$.unknown_field"; 
    }

    public override void Write(Utf8JsonWriter writer, int value, JsonSerializerOptions options)
    {
        writer.WriteNumberValue(value);
    }
}</int>

在类上应用此转换器:

[JsonConverter(typeof(SafeIntConverter))]
public class Product
{
    public int Id { get; set; }
    public decimal Price { get; set; }
}

当使用包含超大整数的 JSON 进行反序列化时,SafeIntConverter 会被调用,并在 TryGetInt32 失败时记录路径。虽然上面的示例中路径获取是简化的,但在实际应用中,可以通过 JsonSerializer 的 PropertyNameCaseInsensitive 或其他机制结合 Utf8JsonReader 的状态来构建完整路径。

当 JSON 数组元素导致范围错误时,如何定位具体索引?

在处理 JSON 数组时,如果某个元素的数值超出范围,JsonException 的 Path 属性会包含数组索引,例如 $[0].Price。这使得定位变得非常直接。无需额外逻辑,只需捕获异常并解析 Path 即可知道是哪个数组元素、哪个字段出了问题。

using System;
using System.Text.Json;
using System.Text.Json.Serialization;

public class OrderItem
{
    public int Quantity { get; set; }
}

public class Order
{
    public OrderItem[] Items { get; set; }
}

public class Program
{
    public static void Main()
    {
        var options = new JsonSerializerOptions
        {
            NumberHandling = JsonNumberHandling.Strict
        };

        string json = @"{"Items": [{"Quantity": 10}, {"Quantity": 999999999999999999999}]}";

        try
        {
            var order = JsonSerializer.Deserialize<order>(json, options);
        }
        catch (JsonException ex)
        {
            Console.WriteLine($"Error at path: {ex.Path}");
            // Output: Error at path: $.Items[1].Quantity
        }
    }
}</order>

该代码展示了当 Items 数组中第二个元素(索引 1)的 Quantity 超出 int 范围时,异常路径明确指向 $.Items[1].Quantity。开发者可以直接根据这个路径更新数据源或向用户反馈具体错误位置。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

js json c#

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
c#是什么意思
c#是什么意思

C#是一种通用的面向对象编程语言,它在.NET框架上运行,可用于开发各种类型的应用程序。本专题为大家提供c#相关的各种文章、以及下载和课程。

2023.08.08

1212

5

什么是c#
什么是c#

C#(读作C Sharp)是一种现代的、通用的、面向对象的编程语言。它由微软公司开发,于2000年首次发布,主要用于开发Windows桌面应用程序、Web应用程序、移动应用程序以及游戏开发等领域。C#是一种类型安全和托管的编程语言,它结合了C++的强大性能和C语言的简单易学特点,并引入了许多新的特性和概念,如委托、属性、泛型和异步编程等,以提高开发效率和代码可维护性。

2023.08.31

3611

3

C#中base关键字的用法
C#中base关键字的用法

在C#中,base关键字用于访问当前类的基类成员,这包括基类的字段、属性、方法、构造函数、索引器以及事件。想了解更多C#的相关内容,可以阅读本专题下面的文章。

2024.03.13

965

8

C#Task用法
C#Task用法

Task在C#中是用于表示异步操作的对象,它位于System.Threading.Tasks命名空间中。想了解更多C#中各种用法的相关内容,可以阅读本专题下面的文章。

2024.03.14

2675

11

C# 并发与异步编程
C# 并发与异步编程

本专题系统讲解 C# 异步编程与并发控制,重点介绍 async 和 await 关键字、Task 类、线程池管理、并发数据结构、死锁与线程安全问题。通过多个实战项目,帮助学习者掌握 如何在 C# 中编写高效的异步代码,提升应用的并发性能与响应速度。

2026.02.03

372

18

C# 多线程与异步编程
C# 多线程与异步编程

本专题深入讲解 C# 中多线程与异步编程的核心概念与实战技巧,包括线程池管理、Task 类的使用、async/await 异步编程模式、并发控制与线程同步、死锁与竞态条件的解决方案。通过实际项目,帮助开发者掌握 如何在 C# 中构建高并发、低延迟的异步系统,提升应用性能和响应速度。

2026.02.06

449

20

C# ASP.NET Core微服务架构与API网关实践
C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开,系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例,帮助开发者掌握构建高可用微服务系统的关键技术,提高系统的可扩展性与维护效率。

2026.03.11

631

24

C# Unity游戏开发与ECS架构实践
C# Unity游戏开发与ECS架构实践

本专题聚焦 C# 在 Unity 游戏开发中的应用,系统讲解 ECS(Entity-Component-System)架构设计、游戏对象管理、性能优化与内存控制策略。通过实际游戏案例,帮助开发者构建高性能、结构清晰的游戏系统,提高游戏开发效率与运行性能。

2026.04.13

349

20

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2395

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 21.4万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.9万人学习