Jenkins部署.NET 6至IIS遇授权失败，请求排查解决

目标 #

通过Jenkins构建机将.NET应用部署至IIS服务器。

错误信息 #

Web部署任务失败。已通过Web Management Service连接到远程计算机("xx.xx.xxx.x")，但无法授权。请确保使用正确的用户名和密码，目标站点存在，且凭据对应的用户拥有站点访问权限。

背景 #

我有一个包含5个项目的.NET解决方案（主项目、测试项目、测试模拟器、服务间共享对象项目、定制第三方库），使用Jenkins自由风格任务构建部署时出现上述错误；但单个项目的.NET解决方案可通过Jenkins正常部署。

问题 #

我可通过Visual Studio手动发布单个项目，但无法通过命令行部署解决方案（甚至单个项目）。

命令行操作步骤 #

• 最初尝试用以下命令部署解决方案，根据文档得知多项目无法此操作：

  msbuild project_name.sln /p:DeployOnBuild=true /p:PublishProfile="staging"
  

• 随后为其他项目添加与主项目同名的发布配置文件，仍出现相同错误。
• 尝试仅部署主项目，执行以下命令后仍报错：

  msbuild path_to_project\projectname.csproj /p:DeployOnBuild=true /p:PublishProfile=staging /p:VisualStudioVersion=22.0 /p:Password="mypassword" /p:AllowUntrustedCertificate=true
  

发布配置文件 #

<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <PropertyGroup>
    <WebPublishMethod>MSDeploy</WebPublishMethod>
    <AllowUntrustedCertificate>True</AllowUntrustedCertificate>
    <LastUsedBuildConfiguration>Release</LastUsedBuildConfiguration>
    <LastUsedPlatform>Any CPU</LastUsedPlatform>
    <SiteUrlToLaunchAfterPublish>http://myurl:80/</SiteUrlToLaunchAfterPublish>
    <LaunchSiteAfterPublish>True</LaunchSiteAfterPublish>
    <ExcludeApp_Data>False</ExcludeApp_Data>
    <ProjectGuid>projectguid</ProjectGuid>
    <MSDeployServiceURL>https://xx.xx.xxx.xx:8172/msdeploy.axd</MSDeployServiceURL>
    <DeployIisAppPath>appName</DeployIisAppPath>
    <RemoteSitePhysicalPath />
    <SkipExtraFilesOnServer>True</SkipExtraFilesOnServer>
    <MSDeployPublishMethod>WMSVC</MSDeployPublishMethod>
    <EnableMSDeployBackup>True</EnableMSDeployBackup>
    <EnableMsDeployAppOffline>True</EnableMsDeployAppOffline>
    <UserName>xx.xx.xxx.xx\Administrator</UserName>
    <_SavePWD>True</_SavePWD>
    <TargetFramework>net6.0</TargetFramework>
    <SelfContained>false</SelfContained>
  </PropertyGroup>
</Project>

1. 凭据与权限验证 #

• 检查命令行传入的密码是否正确，若密码包含特殊字符（如$、&、!），需在命令行中进行转义（Windows命令行用^，PowerShell用`）。
• 确认用户名格式：若目标服务器是本地账号，可尝试改用.\Administrator替代xx.xx.xxx.xx\Administrator；若为域账号，需使用域名\账号格式，且确保构建机已加入对应域。
• 在目标IIS服务器上验证权限：
  1. 右键目标站点→编辑权限，确认用户拥有读写权限。
  2. 检查用户是否添加至IIS管理器权限组（在IIS管理器的「管理用户」中配置）。

2. 发布配置与命令行参数优化 #

• 发布配置已设置AllowUntrustedCertificate=True，可移除命令行中的/p:AllowUntrustedCertificate=true参数，避免冗余。
• 确认VisualStudioVersion=22.0与构建机安装的VS版本匹配（22.0对应VS2022），若为其他版本需修改参数（如VS2019对应16.0）。
• 检查MSDeployServiceURL是否正确，确保目标服务器8172端口已开放，Web Management Service（WMSVC）处于运行状态。

3. 多项目解决方案部署流程调整 #

• 无需给非Web项目添加发布配置，仅主Web项目需要部署，其他类库项目只需编译输出到主项目依赖目录。
• 修改Jenkins任务为两步执行：
  1. 编译整个解决方案：

     msbuild project_name.sln /p:Configuration=Release /p:Platform="Any CPU"
     

  2. 单独部署主Web项目：

     msbuild path_to_project\projectname.csproj /p:DeployOnBuild=true /p:PublishProfile=staging /p:Password="mypassword"
     

4. 构建机环境验证 #

• 确保构建机已安装：
  • .NET 6 SDK
  • Web Deploy工具（MSDeploy）
  • 对应版本的Visual Studio构建工具（如VS2022 Build Tools）
• 在构建机命令行手动执行部署命令，复现错误排查环境问题，排除Jenkins任务配置干扰。
• 检查Jenkins服务运行账号权限：若使用默认账号无远程部署权限，可在命令行明确指定凭据，或给Jenkins账号添加对应权限。

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