Jenkins SCP显示成功但目标服务器无文件问题排查咨询

我之前确实碰到过完全一样的问题！当时折腾了好半天才找到根源，也摸索出几个能在远程端记录更多细节的办法，分享给你：

一、如何在远程端记录SCP连接之外的更多日志 #

1. 开启远程SSH服务的详细日志 #

在目标服务器的/etc/ssh/sshd_config配置文件中，修改或添加以下配置：

LogLevel VERBOSE

保存后重启SSH服务（不同系统命令略有不同，比如systemctl restart sshd或者service ssh restart）。之后SSH会把包括SCP传输在内的所有操作细节都记录下来，日志文件一般在：

• Debian/Ubuntu：/var/log/auth.log
• RHEL/CentOS/Rocky Linux：/var/log/secure

2. 给SCP命令加调试参数 #

别用Jenkins SCP插件的默认配置了，改用执行shell脚本的方式手动调用scp命令，加上-v（verbose）参数，示例：

scp -v /var/lib/jenkins/workspace/your-project/build/* deploy@remote-server:/opt/app/

这个-v会把SCP从建立连接、文件校验到传输完成的每一步都输出到Jenkins的构建日志里，同时远程端的SSH日志也会对应记录，两边对照着看，很容易揪出问题。

3. 远程端添加传输后验证脚本 #

在Jenkins的SCP命令之后，加一个远程执行的验证步骤，登录到目标服务器检查文件状态，并把结果写入日志：

ssh deploy@remote-server "
  echo '=== Jenkins SCP Verification Log ===' > /var/log/jenkins_scp_check.log
  date >> /var/log/jenkins_scp_check.log
  echo 'Target directory content:' >> /var/log/jenkins_scp_check.log
  ls -l /opt/app/ >> /var/log/jenkins_scp_check.log 2>&1
  echo 'Total files:' $(ls -1 /opt/app/ | wc -l) >> /var/log/jenkins_scp_check.log
"

这样哪怕SCP提示成功，也能通过这个日志确认文件是否真的存在、数量对不对。

二、我遇到过的类似问题及解决办法 #

当时我的场景是Jenkins显示传输了8个文件，全部成功，但目标服务器上完全找不到。排查后发现两个核心原因：

1. 目标路径是软链接，SCP未跟随 #

我指定的目标目录是一个软链接（比如/opt/app指向/data/app），但SCP默认不会自动跟随软链接传输文件——结果文件其实被传到了软链接所在目录的/opt/app文件里（直接覆盖了软链接），而不是真实的/data/app目录。
解决办法：要么直接用真实路径，要么给SCP加-r参数（如果是传输目录），或者添加-T参数禁用严格的文件名检查。

2. SELinux拦截了文件传输 #

目标服务器开启了SELinux，虽然目标目录权限是777，但Jenkins的SSH用户没有对应的SELinux上下文权限，导致文件传输后被悄悄拦截了（SCP本身不会报错）。
解决办法：可以先临时关闭SELinux测试（setenforce 0），如果问题消失，再给目标目录添加正确的SELinux上下文，比如：

chcon -t httpd_sys_content_t /opt/app/

（如果是web应用目录，根据实际场景调整上下文类型）

另外还有个小概率情况：Jenkins SCP插件缓存了旧的远程服务器信息（比如目标服务器IP变更了），导致文件传到了错误的机器上。这种情况可以试试删除插件的远程服务器配置，重新添加一遍，或者直接用手动scp命令代替插件。

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