更新WCF服务引用后客户端未生成GridService.svc/js文件的排查求助

问题描述 #

更新AjaxWebService服务引用后，客户端可正常生成https://test/portal/ajaxwebService.svc/js文件，文件包含对应API名称；但更新GridService服务引用后，预期的https://test/portal/GridService.svc/js文件不存在，浏览器控制台报404（Not Found）错误。已确认两个服务均为.NET WCF项目，服务配置及web.config文件相似，暂未找到根因。

排查及解决建议 #

1. 服务端配置核对 #

• 检查GridService的.svc文件是否正确部署到服务器/portal路径下，确认文件存在且IIS应用池账户拥有读取权限
• 对比两个服务的web.config核心节点：
  • 查看<system.serviceModel>下的<services>节点，GridService是否配置了webHttpBinding，且对应endpoint绑定了包含<webHttp/>的行为
  • 确认<behaviors>的<endpointBehaviors>中，是否为GridService添加了<enableWebScript/>行为（这是生成JS代理的必要配置）
  • 检查GridService的endpoint地址格式，是否与AjaxWebService保持一致
• 验证GridService类的特性标记：
  • 类需添加[ServiceContract(Namespace = "xxx")]特性
  • 需生成JS代理的方法，必须同时标记[OperationContract]和[WebGet]/[WebInvoke]特性

2. 客户端引用操作检查 #

• 重新添加GridService引用时，在「高级设置」中确认勾选启用AJAX服务选项
• 检查客户端配置文件（app.config/web.config），确认GridService的endpoint使用webHttpBinding，且行为配置正确
• 手动删除客户端的GridService引用，清理项目缓存后重新添加，避免旧配置残留

3. 服务器运行状态验证 #

• 在服务器本地访问https://test/portal/GridService.svc，确认服务能正常加载（无报错页面）
• 查看IIS日志，定位404请求的详细记录，确认请求路径与实际部署路径是否匹配，排查是否有URL重写规则干扰
• 检查服务器是否安装了对应.NET版本的WCF HTTP激活组件，确保服务可正常处理HTTP请求

4. 服务代码验证 #

• 检查GridService类是否存在语法错误或未处理的初始化异常，导致服务无法正常启动
• 确认GridService方法的参数、返回类型均为可序列化类型，避免因序列化失败导致服务无法生成JS代理

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