Azure HTTP触发函数自动反序列化Decimal是否受区域设置影响？

云上老周

2026-5-14

问题分析与解决方案

首先咱们来拆解你遇到的这个问题：为什么Azure函数的自动绑定会依赖系统区域设置，而手动用JsonConvert反序列化就没问题？

核心原因：模型绑定与JSON序列化的行为差异

Azure Functions的HTTP触发器自动模型绑定，底层依赖的是ASP.NET Core的模型绑定系统。这个系统在处理数值类型（比如decimal）转换时，默认会使用当前系统的区域设置——你的本地环境是德语区域，德语用逗号（,）作为小数分隔符，但你POST的JSON里用的是标准的点（.），这就导致解析时格式不匹配，抛出「输入字符串格式不正确」的错误。

而你手动用JsonConvert.DeserializeObject时，Newtonsoft.Json（默认的JSON序列化库）**默认使用不变文化（CultureInfo.InvariantCulture）**来解析数值，不变文化是基于英语区域的，用点作为小数分隔符，刚好匹配JSON的标准格式，所以反序列化正常。

关于设计合理性的疑问

其实这个差异是由两者的职责不同导致的：

模型绑定不仅处理JSON请求，还需要处理表单数据、路由参数、查询字符串等场景——这些场景下，区域相关的解析逻辑是有意义的（比如某些地区用户输入的数值用逗号分隔）。
但JSON本身是有明确规范的：数值必须用点作为小数分隔符。所以模型绑定在处理JSON时沿用系统区域的行为，确实容易造成跨环境的兼容性问题，这也是为什么很多开发者会选择手动控制JSON反序列化的原因。

解决方案

针对这个问题，有几种可行的解决方法：

1. 全局设置不变文化（推荐）

在Azure Functions的启动配置中，将默认线程文化设置为不变文化，确保所有模型绑定和序列化操作都使用标准的数值格式：

// 进程内模型的Startup.cs
public class Startup : FunctionsStartup
{
    public override void Configure(IFunctionsHostBuilder builder)
    {
        // 设置全局默认文化为不变文化
        CultureInfo.DefaultThreadCurrentCulture = CultureInfo.InvariantCulture;
        CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.InvariantCulture;
    }
}

// 隔离进程模型的Program.cs
var host = new HostBuilder()
    .ConfigureFunctionsWorkerDefaults()
    .ConfigureServices(services =>
    {
        CultureInfo.DefaultThreadCurrentCulture = CultureInfo.InvariantCulture;
        CultureInfo.DefaultThreadCurrentUICulture = CultureInfo.InvariantCulture;
    })
    .Build();

host.Run();

这样无论函数部署在哪个区域，都会用标准的点分隔符解析JSON数值，彻底避免区域依赖问题。

2. 手动控制JSON反序列化（你已尝试的方法）

继续使用接收string或HttpRequest参数的方式，手动用Newtonsoft.Json反序列化，这种方式能完全掌控反序列化逻辑：

[FunctionName("GenerateLabelGLSFunctionHttpTrigger")]
public async Task<IActionResult> Run(
    [HttpTrigger(AuthorizationLevel.Anonymous, "post", Route = "label/gls")] HttpRequest req,
    ILogger log) 
{
    var requestBody = await new StreamReader(req.Body).ReadToEndAsync();
    var labelInformation = JsonConvert.DeserializeObject<LabelInformation>(requestBody);
    
    // 后续业务逻辑...
}

3. 给Decimal字段添加自定义JSON转换器

如果只想针对特定字段处理，可以给Weight字段添加自定义转换器，强制用不变文化解析：

public class LabelInformation {
    public ParcelAddress? Receiver { get; set; }
    public string? ReferenceNumber { get; set; }
    
    [JsonConverter(typeof(InvariantDecimalConverter))]
    public decimal? Weight { get; set; }
}

public class InvariantDecimalConverter : JsonConverter<decimal?>
{
    public override decimal? ReadJson(JsonReader reader, Type objectType, decimal? existingValue, bool hasExistingValue, JsonSerializer serializer)
    {
        if (reader.Value == null) return null;
        
        return decimal.Parse(reader.Value.ToString(), CultureInfo.InvariantCulture);
    }

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

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