C# SOAP客户端设置多级API字段时遇NullPointerException求助

嘿，别着急，这是SOAP客户端开发里超常见的坑！我之前帮同事排查过几乎一模一样的问题，根源其实很简单：你没有逐层初始化嵌套的对象实例。

问题原因 #

从你给出的XML请求片段能看出来，OrderAmount和OrderRef并不是直接挂在CreateOrderRequest根对象上的，它们的层级关系是：
CreateOrderRequest → Orders → OrderLine → OrderAmount/OrderRef

而C#通过WSDL自动生成的SOAP类里，所有引用类型（比如Orders、OrderLine）默认都是null，你直接跳过中间层级去赋值底层属性，自然会触发NullReferenceException。

解决方案 #

你需要逐层初始化所有嵌套的对象，再给属性赋值。下面是对应你的场景的代码示例：

// 初始化主请求对象
CreateOrderRequest createOrder = new CreateOrderRequest();
createOrder.ProductCode = "RX888";

// 1. 先初始化Orders对象（根据自动生成的类结构，可能包含OrderLine的集合）
createOrder.Orders = new Orders();
// 如果生成的Orders类里的OrderLine是集合类型（比如List<OrderLine>），要先初始化集合
createOrder.Orders.OrderLines = new List<OrderLine>();

// 2. 初始化单个OrderLine并赋值
var orderLine = new OrderLine();
orderLine.OrderAmount = 5.99m; // 建议用decimal类型处理金额，避免浮点精度问题
orderLine.OrderRef = "test";

// 3. 把OrderLine添加到Orders的集合中
createOrder.Orders.OrderLines.Add(orderLine);

额外提示 #

• 你可以右键点击自动生成的SOAP类（比如CreateOrderRequest、Orders），选择「转到定义」，查看它们的具体结构，确认属性名称和类型，避免写错层级。
• 因为XML里<data:Orders>标注了「Zero or more repetitions」，所以Orders里的OrderLine大概率是集合类型（比如List<OrderLine>或者OrderLine[]），记得先初始化集合再添加元素。

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