Windows环境下Plesk面板部署WebApi遇503/502.5错误求助

以下是针对你遇到的问题的具体排查和解决步骤：

1. 验证ASP.NET Core Runtime环境 #

• 确保服务器已安装与你发布的WebApi版本匹配的ASP.NET Core Runtime（如.NET 6/.NET 7）。可通过Plesk的「工具与设置」>「服务器组件」查看已安装组件，缺失则手动下载对应版本安装。

2. 检查应用程序池配置 #

• 503错误多与应用池异常相关：
  • 将应用池的**.NET CLR版本**设置为「无托管代码」（ASP.NET Core为自托管模式，无需IIS托管CLR）。
  • 确认应用池身份权限：若使用ApplicationPoolIdentity，需给应用根目录添加该身份的读写权限；若用自定义账号，确保账号具备访问应用目录和数据库的权限。

3. 排查web.config配置问题 #

你的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=".\AppName.RestApi.exe" stdoutLogEnabled="true" stdoutLogFile=".\logs\stdout" hostingModel="inprocess" />
    </system.webServer>
  </location>
</configuration>

• 核对processPath：确保AppName.RestApi.exe与你发布的实际可执行文件名完全一致，注意文件名大小写（Windows环境下虽不严格区分，但Plesk中偶有兼容性问题）。
• 利用日志定位问题：stdoutLogEnabled="true"已开启，前往应用根目录的logs文件夹查看最新日志文件，日志会明确记录启动失败的具体原因（如依赖缺失、数据库连接失败）。
• 针对不同托管模式的调整：
  • inprocess模式：必须确保应用池CLR版本为「无托管代码」，否则会触发503错误。
  • outofprocess模式：若出现502.5错误，优先检查日志中是否有Kestrel端口占用提示；也可尝试将modules改为AspNetCoreModule（兼容旧版本模块）。

4. 验证数据库连接字符串 #

你的appsettings.json连接字符串如下：

{ "dbConnectionString": "Data Source=.\\MSSQLSERVER2019;Initial Catalog=<DataBaseName>;User ID=<UserName>;Password=<Password>" }

• 确认实例名正确性：Data Source=.\\MSSQLSERVER2019中的MSSQLSERVER2019需与SQL Server的实际命名实例一致，可通过SQL Server配置管理器查看「SQL Server服务」中的实例名称；若为默认实例，直接使用Data Source=.;更稳妥。
• 替换占位符：务必将<DataBaseName>、<UserName>、<Password>替换为真实的数据库名、账号和密码，且该SQL账号需具备目标数据库的读写权限。可通过SSMS测试该账号能否正常连接数据库。

5. 检查应用目录权限 #

• 给应用根目录添加IIS AppPool\<你的应用池名称>的读写权限，尤其是logs目录，否则日志无法写入，也可能导致应用启动失败。
• 确认可执行文件未被拦截：检查exe文件是否被杀毒软件锁定，或发布包是否解压完整。

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