修改WCF服务返回类型后调用报500内部服务器错误如何解决

你修改返回类型后所有接口都报500，说明WCF服务在初始化阶段就已经出错、无法正常启动，所以所有请求都返回错误。可以先直接在浏览器访问服务的.svc地址，如果无法正常打开元数据页面，就能确认是服务本身启动失败。

1. 修复数据契约的循环引用问题 #

你当前定义的OrderDetails类内部又包含了类型为List<OrderDetails>的字段，属于典型的自引用循环结构，WCF默认的XML序列化器无法处理这种结构，会直接抛出异常导致服务启动失败。
如果这个自引用字段是业务需要的，给数据契约加上循环引用支持标记即可：

// 加IsReference = true允许序列化器处理循环引用
[DataContract(Name = "OrderDetails", IsReference = true)]
public class OrderDetails
{
    [DataMember]
    // 建议把公共字段改成属性，WCF对属性的序列化兼容性更好
    public List<OrderDetails> lstOrderDetails { get; set; }
}

如果这个自引用字段是写错了，直接替换为你实际需要的业务字段（比如订单号、金额、下单时间等）即可。

2. 修复操作契约的参数不匹配问题 #

你在UriTemplate中定义的参数是OrderNum={OrderNum}，但方法的入参名是input，参数名完全不匹配，WCF做路由参数绑定时会直接报错。修改为参数名一致即可：

[OperationContract]
[WebInvoke(Method = "GET",
    ResponseFormat = WebMessageFormat.Xml,
    BodyStyle = WebMessageBodyStyle.Bare,
    UriTemplate = "checkOrders?OrderNum={orderNum}")] // 参数名和方法入参名保持一致
List<OrderDetails> getAllOrders(string orderNum); // 入参名和UriTemplate里的参数对应

3. 开启WCF详细错误返回排查问题 #

可以临时修改服务的web.config配置，让服务端把具体的错误详情返回给客户端，快速定位问题：

<system.serviceModel>
  <behaviors>
    <serviceBehaviors>
      <behavior>
        <!-- 排查阶段设为true，上线前改回false避免泄露服务信息 -->
        <serviceDebug includeExceptionDetailInFaults="true"/>
      </behavior>
    </serviceBehaviors>
  </behaviors>
</system.serviceModel>

配置完成后再次调用接口，就能直接从响应内容中看到是序列化错误、参数错误还是业务代码的运行时错误。

4. 优化客户端代码捕获错误详情 #

修改请求代码，捕获异常时读取服务端返回的错误信息，不用每次都去服务端查日志：

protected void getOrders_Click(object sender, EventArgs e)
{
    string serviceUrl= url + "/checkOrders?OrderNum=test123";            
    string result = ""; 
    try
    {
        HttpWebRequest request = WebRequest.Create(serviceUrl) as HttpWebRequest;             
        using (HttpWebResponse response = request.GetResponse() as HttpWebResponse)
        {
            StreamReader reader = new StreamReader(response.GetResponseStream());
            result = reader.ReadToEnd();
        }
        lbl.Text = result;
    }
    catch (WebException ex)
    {
        // 读取服务端返回的错误详情
        using (var responseStream = ex.Response.GetResponseStream())
        {
            using (var reader = new StreamReader(responseStream))
            {
                result = reader.ReadToEnd();
            }
        }
        lbl.Text = "报错详情：" + result;
    }
}

5. 检查服务实现代码 #

如果上述配置都修正后还是报错，检查getAllOrders方法的业务实现代码，有没有空引用、数据库连接失败这类运行时异常，可以附加调试器到WCF服务进程直接捕获异常。

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