ASP.NET Core序列化含FileInfo的对象返回不完整JSON问题

你碰到的JSON输出到一半就截断的问题，核心原因不是FileInfo不可序列化，而是这个类本身的结构特性导致默认序列化器处理失败：

FileInfo是和系统文件系统绑定的对象，内部包含大量延迟加载属性和循环引用关系——比如FileInfo.Directory属性会指向它所在的目录对象，而目录对象的Files属性又会反向关联到当前的FileInfo，形成循环；另外部分属性在访问时可能涉及系统权限检查，触发未处理的异常。ASP.NET Core 2.x默认使用的Newtonsoft.Json在遇到这类情况时，无法完整完成序列化流程，直接中途终止，就出现了你看到的半截JSON。

推荐解决方案：使用自定义DTO（数据传输对象） #

这是最安全、最规范的做法，既避免了序列化问题，又不会暴露服务器文件系统的敏感信息。我们只提取需要的文件属性，封装成一个简单的DTO类：

1. 定义DTO类：

public class FileInfoDto
{
    public string FileName { get; set; }
    public long FileSize { get; set; }
    public DateTime LastModifiedTime { get; set; }
    // 按需添加你需要的其他属性，比如文件扩展名、是否只读等
}

2. 修改你的Thing类，用DTO替代FileInfo：

public class Thing 
{ 
    public string Name { get; set; } 
    public FileInfoDto File { get; set; } 
}

3. 在控制器中完成FileInfo到DTO的转换：

[HttpGet]
public async Task<ActionResult<Thing>> GetThing() 
{
    var targetFile = new FileInfo("c:\\file.txt");
    return new Thing() 
    { 
        Name = "First thing", 
        File = new FileInfoDto
        {
            FileName = targetFile.Name,
            FileSize = targetFile.Length,
            LastModifiedTime = targetFile.LastWriteTime
        }
    };
}

备选方案：配置序列化器忽略循环引用与错误 #

如果你确实需要直接返回FileInfo对象，可以通过配置Newtonsoft.Json的序列化选项来跳过问题属性，但这种方法不推荐（可能泄露敏感信息、返回冗余数据）：

在Startup.cs的ConfigureServices方法中添加序列化配置：

public void ConfigureServices(IServiceCollection services)
{
    services.AddMvc()
        .SetCompatibilityVersion(CompatibilityVersion.Version_2_1)
        .AddJsonOptions(options =>
        {
            // 忽略循环引用，避免序列化时陷入无限循环
            options.SerializerSettings.ReferenceLoopHandling = ReferenceLoopHandling.Ignore;
            // 捕获序列化异常并标记为已处理，避免序列化中断
            options.SerializerSettings.Error = (sender, args) =>
            {
                args.ErrorContext.Handled = true;
            };
        });
    services.AddSingleton<Thing>();
}

内容的提问来源于stack exchange，提问作者rory.ap