Jenkins无法访问共享文件夹：ASP.NET部署故障排查求助

这个错误的核心原因是Jenkins服务运行的账户没有访问远程共享文件夹的权限——你在本地cmd执行时用的是当前登录用户（该用户已经有权限访问\\<ip_address>\wwwroot），但Jenkins默认是用Windows的Local System账户运行的，这个账户没有网络访问权限，根本无法识别远程共享路径。

下面给你几个可行的解决办法：

1. 修改Jenkins服务的运行账户（推荐） #

这是最彻底的解决方案：

• 打开Windows服务管理器（按下Win+R，输入services.msc回车）
• 找到Jenkins服务，右键选择「属性」
• 切换到「登录」选项卡，选择「此账户」，输入一个有权限访问远程共享文件夹的域账户或本地账户（提前用这个账户在cmd里测试dir \\<ip_address>\wwwroot，确保能正常访问）
• 输入账户密码后点击确定，重启Jenkins服务
• 再次运行流水线，应该就能正常访问共享路径了

2. 在流水线中临时映射网络驱动器 #

如果不想修改Jenkins服务账户，可以在Batch命令前先映射远程共享：

# 先映射共享到本地驱动器Z:（替换为你的账户信息）
net use Z: \\<ip_address>\wwwroot /user:你的域名\用户名 你的密码

# 执行MSBuild命令（注意把publishUrl改成Z:\，或者保持原路径也可以，映射后会识别）
"c:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe" "C:\path_to_project" /p:SolutionDir="path_to_solution_dir" /p:DeployOnBuild=true /p:Configuration=Release /p:PublishProfile="Profile.pubxml"

# 可选：部署完成后取消映射
net use Z: /delete

⚠️ 注意：明文写密码不安全，建议用Jenkins的「凭据管理」存储密码，然后通过Credentials Binding插件在流水线中引用，避免密码泄露。

3. 调整部署方式（替代方案） #

如果共享文件夹的权限管理太麻烦，可以换更可靠的部署方式：

• Web Deploy（MSDeploy）：修改发布配置文件，把WebPublishMethod改成MSDeploy，配置远程服务器的Web Deploy服务，通过HTTP/HTTPS进行部署，不需要依赖共享文件夹，权限管控更灵活
• Robocopy复制：先用MSBuild编译到本地目录，再用Robocopy命令把文件同步到远程共享，Robocopy支持重试、跳过已存在文件等功能，同样需要确保Jenkins账户有权限访问共享

排查小技巧 #

可以先在Jenkins流水线里加一个测试步骤，验证账户权限：

dir \\<ip_address>\wwwroot

如果这个命令报错，那100%是权限问题，优先解决账户权限即可。

内容的提问来源于stack exchange，提问作者Pavel the coder