本地可访问的.NET API发布至IIS后无法访问，如何配置？

1. 安装必要的.NET托管组件 #

服务器上必须安装对应.NET版本的ASP.NET Core托管包，否则IIS无法处理.NET Core API请求：

• 打开服务器管理器 → 添加角色和功能 → 功能 → 勾选ASP.NET Core托管包（匹配你的API使用的.NET版本，如.NET 6/7/8）
• 若为.NET Framework API，需确保安装IIS的ASP.NET模块（对应.NET Framework版本）

2. 配置应用程序池 #

• 打开IIS管理器 → 找到目标应用程序池 → 高级设置：
  • 将*.NET CLR版本*设置为无托管代码（ASP.NET Core API采用自托管模型，IIS仅做反向代理）
  • 若API需要访问数据库，将身份改为具备数据库访问权限的账户（如域账户、本地管理员，或确保ApplicationPoolIdentity有数据库权限）
  • 回收应用程序池，使配置生效

3. 正确配置网站绑定 #

• 不要直接修改端口文件，通过IIS绑定界面配置：
  • 右键目标网站 → 编辑绑定 → 添加：
    • 类型选HTTPS，端口设为443（标准HTTPS端口，访问时无需在URL后加端口），绑定到你的域名，选择已安装的TLS证书
    • 若需使用7224端口，需单独添加HTTPS绑定，端口设为7224并选择证书，同时确保服务器防火墙开放该端口
  • 移除不必要的HTTP绑定，避免重定向冲突

4. 修复路由与重定向问题 #

• 检查网站根目录的web.config，确保ASP.NET Core重写规则正确：

  <system.webServer>
    <rewrite>
      <rules>
        <rule name="ASP.NET Core" stopProcessing="true">
          <match url="(.*)" />
          <conditions logicalGrouping="MatchAll">
            <add input="{REQUEST_FILENAME}" matchType="IsFile" negate="true" />
            <add input="{REQUEST_FILENAME}" matchType="IsDirectory" negate="true" />
          </conditions>
          <action type="Rewrite" url="." />
        </rule>
      </rules>
    </rewrite>
  </system.webServer>
  

• 删除网站根目录下的index.html文件（API无需静态首页，该文件可能导致不必要的重定向）
• 确认API代码中已启用路由：Program.cs中需包含app.MapControllers();或对应路由配置

5. 验证权限与数据库连接 #

• 给网站物理路径分配权限：右键路径 → 属性 → 安全 → 添加应用程序池身份（格式：IIS AppPool\你的应用程序池名称），勾选读取和执行权限
• 检查生产环境配置文件（appsettings.Production.json）中的数据库连接字符串，确保服务器能访问数据库（如数据库防火墙开放端口、服务器IP在白名单内）

6. 日志排查定位问题 #

• 开启IIS失败请求跟踪：网站功能视图 → 失败请求跟踪规则 → 添加规则，跟踪4xx/5xx状态码，生成日志后查看具体错误细节
• 配置ASP.NET Core stdout日志：修改web.config中的<aspNetCore>节点，开启日志并指定路径，确保日志目录有写入权限：

  <aspNetCore processPath="dotnet" arguments=".\YourApi.dll" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
  

  日志会记录API启动、请求处理中的错误信息，帮助快速定位问题

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