使用Square Connect API创建订单时遭遇Quantity null异常求助

我之前碰到过好几个类似的问题，你明明设置了Quantity = "1"但API还是返回必填错误，大概率是序列化不匹配或者属性类型/定义问题导致的，给你几个具体的排查方向：

1. 检查Quantity的类型是否匹配API要求 #

很多订单类API要求quantity是整数类型（int）而非字符串。你现在传的是字符串"1"，如果API期望数字格式，就会解析失败，最终被识别为null。试试改成整数：

var item = new CreateOrderRequestLineItem() 
{
    CatalogObjectId = "STWMISUMLIIIXU6MVWNFX6FQ",
    Quantity = 1, // 把字符串"1"替换为整数1
    BasePriceMoney = new Money() { Amount = 20, Currency = Money.CurrencyEnum.NPR }
};

2. 验证属性的序列化映射 #

如果你的项目用JSON序列化（比如Newtonsoft.Json或System.Text.Json），一定要确保类的属性名和API要求的字段名完全一致。很多API用小写的quantity，而你的C#属性是大写的Quantity，如果没配置序列化特性，最终生成的JSON里可能没有这个字段，后端自然会认为Quantity是null。

给属性加上序列化特性就能解决：

Newtonsoft.Json写法： #

public class CreateOrderRequestLineItem
{
    [JsonProperty("quantity")] // 严格匹配API的字段名
    public string Quantity { get; set; }
    // 其他属性...
}

System.Text.Json写法： #

public class CreateOrderRequestLineItem
{
    [JsonPropertyName("quantity")]
    public string Quantity { get; set; }
    // 其他属性...
}

3. 检查属性的可访问性 #

确认CreateOrderRequestLineItem类里的Quantity属性是可读写的（同时有get和set方法）。如果属性只有set没有get，序列化框架根本读取不到你设置的值，自然不会把这个字段加入请求中。

4. 手动序列化调试 #

把你的item对象直接序列化成JSON字符串，看看输出里有没有quantity字段以及对应的值：

// Newtonsoft.Json
var json = JsonConvert.SerializeObject(item);
// System.Text.Json
var json = JsonSerializer.Serialize(item);
Console.WriteLine(json);

如果输出里找不到quantity字段，那肯定是序列化环节出了问题，回到前面的步骤逐一排查即可。

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