通过Jenkins SSH执行SQL脚本失败，主机直接执行正常求排查

我来帮你排查这个问题，这种本地执行正常但Jenkins远程执行出问题的情况，通常是执行时机或者环境上下文的差异导致的，咱们一步步来解决：

1. 最可能的原因：MySQL容器启动后未就绪就执行脚本 #

docker run -d是后台启动容器，容器进程起来了，但MySQL服务还需要初始化（比如创建系统表、加载配置），这时候立刻执行脚本就会出现连接失败的错误。

解决方案：在脚本开头添加等待MySQL就绪的逻辑
把这段代码放在databasescript.sh的最开头，循环检查MySQL是否能正常连接，直到就绪或者超时：

# 等待MySQL服务就绪，最多等待300秒（可调整）
MAX_WAIT=300
WAIT_COUNT=0
until docker exec -i nameofthecontainer /usr/bin/mysql -u $MYSQLUSER -pPassword $MYSQLDB -e "SELECT 1;" > /dev/null 2>&1; do
    if [ $WAIT_COUNT -ge $MAX_WAIT ]; then
        echo "MySQL启动超时，退出脚本"
        exit 1
    fi
    echo "Waiting for MySQL to start... ($WAIT_COUNT/$MAX_WAIT seconds)"
    sleep 5
    WAIT_COUNT=$((WAIT_COUNT+5))
done

2. 检查SSH执行时的环境变量是否加载 #

直接在主机执行脚本时，你的shell会自动加载~/.bashrc或/etc/profile里的环境变量（比如$MYSQLUSER、$MYSQLDB），但Jenkins通过SSH执行时默认是非交互式shell，不会加载这些配置，导致变量为空，进而引发连接错误。

解决方案：

• 方案一：在脚本开头手动加载环境配置：

  # 加载当前用户的环境变量
  source ~/.bashrc
  # 或者加载系统级环境变量
  source /etc/profile
  

• 方案二：在Jenkins的SSH命令里直接export所需变量：

  sh '(sudo sshpass -p "PASSWORD" ssh -o StrictHostKeyChecking=no $user@host "export MYSQLUSER=your_user MYSQLDB=your_db && /opt/docker/dockerdeployment/databasescript.sh")'
  

3. 修复脚本里的语法错误 #

注意到你的脚本最后有个done，但前面没有对应的while/for循环语句，这会导致脚本执行到这里报错，甚至中断前面的操作，先把这个多余的done删掉。

4. 强制使用TCP连接而非Socket #

错误信息里提到了socket连接失败，可能是因为远程执行时默认尝试通过本地socket连接，但容器内的MySQL是监听TCP端口的。可以在mysql命令里加上-h 127.0.0.1强制使用TCP连接：

sudo docker exec -i nameofthecontainer /usr/bin/mysql -h 127.0.0.1 -u $MYSQLUSER -pPassword $MYSQLOPTIONS $MYSQLDB -e "DROP DATABASE IF EXISTS ${MYSQLDB};CREATE DATABASE ${MYSQLDB} DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;"
sudo docker exec -i nameofthecontainer /usr/bin/mysql -h 127.0.0.1 -u $MYSQLUSER -pPassword $MYSQLOPTIONS $MYSQLDB < /srv/Dump.sql

5. 检查sudo权限问题 #

Jenkins通过SSH执行时使用的用户，在远程主机上执行sudo是否需要密码？如果需要的话，即使你用了sshpass，远程的sudo操作也会卡住，导致脚本执行失败。

解决方案：
在远程主机的sudoers文件里配置该用户免密执行相关命令：

1. 执行sudo visudo打开配置文件
2. 添加以下内容（替换your_user为实际的SSH用户名）：

   your_user ALL=(ALL) NOPASSWD: /usr/bin/docker, /opt/docker/dockerdeployment/databasescript.sh
   

3. 保存退出后，就可以不用在脚本里加sudo，或者执行时无需输入sudo密码。

建议你先从第1、3点开始排查，这两个是最常见的原因，应该能解决大部分问题。

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