Blazor .NET 8全局配置JSON序列化匹配驼峰字段问题求助

DevOps 小满

2026-7-9

解决Blazor .NET 8中System.Text.Json全局驼峰命名配置不生效的问题

问题原因

你使用的builder.Services.Configure<JsonSerializerOptions>是配置全局默认的JsonSerializerOptions实例，但ASP.NET Core的不同组件（比如Web API控制器、Blazor HttpClient）会维护独立的JsonSerializerOptions配置，不会自动继承全局设置，所以你的配置未生效。

针对不同场景的全局配置方案

1. Web API控制器返回JSON（Blazor Server/Hosted项目的API层）

在配置服务时，需通过AddControllers().AddJsonOptions配置控制器专用的序列化选项：

builder.Services.AddControllers()
    .AddJsonOptions(options =>
    {
        // 设置属性命名策略为驼峰式
        options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
        // 可选：忽略空值属性
        // options.JsonSerializerOptions.DefaultIgnoreCondition = JsonIgnoreCondition.WhenWritingNull;
    });

2. Blazor WebAssembly中使用HttpClient处理JSON

方式一：全局配置所有HttpClient

builder.Services.ConfigureHttpClientJsonOptions(options =>
{
    options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
});

方式二：为特定命名HttpClient配置

builder.Services.AddHttpClient("ApiClient", client =>
{
    client.BaseAddress = new Uri(builder.HostEnvironment.BaseAddress);
})
.AddJsonOptions(options =>
{
    options.JsonSerializerOptions.PropertyNamingPolicy = JsonNamingPolicy.CamelCase;
});

3. 手动调用`JsonSerializer`序列化/反序列化

注入全局配置的IOptions<JsonSerializerOptions>，使用其值完成序列化：

// 在组件或服务中注入依赖
private readonly IOptions<JsonSerializerOptions> _jsonOptions;

public MyComponent(IOptions<JsonSerializerOptions> jsonOptions)
{
    _jsonOptions = jsonOptions;
}

// 序列化示例
var jsonString = JsonSerializer.Serialize(stockItem, _jsonOptions.Value);