.NET客户端调用WCF出现序列化异常，Soap UI调用无此问题

我来帮你排查这个困扰——这种「.NET客户端序列化报错但SoapUI调用正常」的情况，几乎都是EF实体的导航属性+延迟加载和WCF序列化机制冲突导致的，咱们拆解来看：

问题根源分析 #

你的Organization类里有个virtual MerchantAuxRecord导航属性，这个virtual关键字是EF用来实现延迟加载的标志。当EF上下文开启延迟加载时，查询出来的Organization其实是EF动态生成的代理类（而非你定义的纯Organization类），这个代理类会包含EF的额外逻辑。

• SoapUI能正常调用：因为服务端返回的SOAP XML里只有你标记[DataMember]的字段，SoapUI只解析XML结构，不管背后的代理类。
• .NET客户端报错：WCF的DataContractSerializer会严格按照你定义的Organization类结构去反序列化，但代理类的额外属性（EF注入的延迟加载逻辑）会打破这个结构，导致序列化异常。

具体解决方案（按推荐程度排序） #

1. 使用DTO（数据传输对象）传递数据（最推荐）

不要直接把EF实体暴露给WCF服务，专门定义一个用于传输的DTO类，只包含客户端需要的字段：

[DataContract]
public class OrganizationDto
{
    [DataMember]
    public int Id { get; set; }
    
    [DataMember]
    public string Name { get; set; }
    
    // 如果需要MerchantAux的部分数据，在这里添加对应的属性即可
}

然后在服务端把EF实体映射到DTO再返回：

// 服务端业务逻辑
using(var context = new YourDbContext())
{
    // 提前Include需要关联的数据，避免延迟加载
    var org = context.Organizations
                     .Include(o => o.MerchantAuxRecord)
                     .FirstOrDefault(o => o.Id == targetId);
                     
    var dto = new OrganizationDto
    {
        Id = org.Id,
        Name = org.Name
        // 如需传递MerchantAux数据，这里映射对应的字段
    };
    
    return dto;
}

这种方式彻底隔离了EF实体和WCF传输模型，避免了所有因EF代理、导航属性带来的序列化问题，也是企业级开发的标准做法。

2. 关闭当前查询的EF延迟加载

如果你暂时不想改DTO，在查询Organization时关闭延迟加载，让EF返回纯实体类：

using(var context = new YourDbContext())
{
    // 关闭当前上下文的延迟加载
    context.Configuration.LazyLoadingEnabled = false;
    
    // 查询时可以用Include提前加载关联的MerchantAuxRecord
    var org = context.Organizations
                     .Include(o => o.MerchantAuxRecord)
                     .FirstOrDefault(o => o.Id == targetId);
                     
    return org;
}

这样查询出来的Organization是你定义的纯类，没有EF代理，WCF可以正常序列化。

3. 标记导航属性为[IgnoreDataMember]

如果客户端不需要MerchantAuxRecord数据，直接在这个属性上添加[IgnoreDataMember]，让WCF序列化时忽略它：

[DataContract]
public class Organization : Core.Framework.BaseEntity 
{
    [Key]
    [DataMember]
    public int Id { get; set; }
    
    [DataMember]
    public string Name { get; set; }
    
    // 添加IgnoreDataMember，WCF序列化时会跳过这个属性
    [IgnoreDataMember]
    public virtual MerchantAux MerchantAuxRecord { get; set; }
    
    public Organization() { }
}

4. 全局禁用EF代理创建

如果你的项目不需要EF的延迟加载功能，可以在DbContext的构造函数里全局禁用代理创建：

public class YourDbContext : DbContext
{
    public YourDbContext()
    {
        this.Configuration.ProxyCreationEnabled = false;
    }
}

这样EF永远不会生成代理类，实体都是纯类，但代价是失去延迟加载的能力，需要根据业务场景权衡。

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