.NET Core 6.0 SOAP Web服务发布至IIS失败，求配置指导

一、基础环境与IIS配置检查 #

• 确认目标服务器已安装ASP.NET Core 6.0 Runtime（Hosting Bundle）：这是.NET Core应用在IIS运行的核心依赖，必须包含ASP.NET Core Module。可通过控制面板「程序和功能」查看是否安装，未安装则需下载对应版本安装包完成部署。
• 检查端口占用：用命令netstat -ano | findstr :1819验证端口1819是否被其他程序占用，若被占用需更换端口或终止占用进程。
• 应用程序池设置规范：
  • .NET CLR版本必须设为无托管代码，因为.NET Core应用为自托管模式，无需IIS的托管CLR支持。
  • 应用程序池身份需具备发布目录的读写权限，测试阶段可临时设为LocalSystem，确认正常后再调整为更安全的ApplicationPoolIdentity。

二、项目发布配置验证 #

• 发布模式选择Release：Visual Studio发布时务必选Release模式，Debug模式含调试配置，不适合生产环境部署。
• 确认发布文件完整性：发布目录需包含web.config、项目dll、依赖dll及Service.asmx文件。若缺少Service.asmx，检查项目中该文件的「复制到输出目录」属性是否设为「始终复制」或「如果较新则复制」。
• 标准web.config配置示例：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <location path="." inheritInChildApplications="false">
    <system.webServer>
      <handlers>
        <add name="aspNetCore" path="*" verb="*" modules="AspNetCoreModuleV2" resourceType="Unspecified" />
      </handlers>
      <aspNetCore processPath="dotnet" arguments=".\YourService.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

将YourService.dll替换为实际项目dll名称，开启stdoutLogEnabled="true"可生成日志排查具体错误。

三、网络与权限排查 #

• 服务器防火墙配置：确保端口1819已添加入站规则，允许本地/外部访问。
• 本地访问测试：在目标服务器直接访问http://localhost:1819/Service.asmx，若仍无响应则问题在服务器内部配置；若可访问则排查客户端与服务器的网络连通性。
• 查看IIS日志：默认存储路径为C:\inetpub\logs\LogFiles，通过日志中的状态码（如404、500）定位具体问题。

四、SOAP服务特定配置检查 #

• Program.cs终结点配置示例：

var builder = WebApplication.CreateBuilder(args);
builder.Services.AddControllersWithViews();
// 注册SOAP服务实例
builder.Services.AddSingleton<Service>();
builder.Services.AddSoapCore();

var app = builder.Build();
app.UseRouting();
app.UseEndpoints(endpoints =>
{
    endpoints.MapControllers();
    // 配置SOAP服务路由
    endpoints.MapSoapService<Service>("/Service.asmx", new SoapEncoderOptions());
});
app.Run();

• Service.asmx文件内容规范：

<%@ WebService Language="C#" CodeBehind="Service.cs" Class="YourNamespace.Service" %>

替换YourNamespace.Service为实际的服务命名空间和类名。

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