Docker构建MSSQL镜像无法完成，求修复与Dockerfile优化方案

问题根源 #

你的Dockerfile构建卡住主要有两个核心问题：

1. 匹配字符串错误：grep -q "Starting database restore"完全不匹配SQL Server启动时的日志输出，导致后续的sqlcmd永远不会执行，而后台运行的sqlservr一直占用进程，构建无法结束。
2. 还原命令缺失关键参数：直接执行RESTORE DATABASE没有指定MOVE选项，备份文件中记录的原始数据/日志文件路径和容器内的默认路径不匹配，即便服务就绪，还原也会失败。

修复后的Dockerfile #

先创建一个restore-db.sh脚本（和Dockerfile同目录）：

#!/bin/bash

# 启动SQL Server服务
/opt/mssql/bin/sqlservr --accept-eula &
PID=$!

# 等待服务就绪（官方推荐的检测方式）
until /opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P "$MSSQL_SA_PASSWORD" -Q "SELECT 1" > /dev/null 2>&1; do
    echo "等待SQL Server服务就绪..."
    sleep 5
done

# 执行数据库还原，指定MOVE参数适配容器路径
/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P "$MSSQL_SA_PASSWORD" -d master -Q "
RESTORE DATABASE AdventureWorks2022
FROM DISK='/var/opt/mssql/backup/AdventureWorks2022.bak'
WITH MOVE 'AdventureWorks2022' TO '/var/opt/mssql/data/AdventureWorks2022.mdf',
MOVE 'AdventureWorks2022_log' TO '/var/opt/mssql/data/AdventureWorks2022_log.ldf',
REPLACE, NORECOVERY;
RESTORE DATABASE AdventureWorks2022 WITH RECOVERY;
"

# 停止SQL Server服务，确保RUN阶段正常结束
kill $PID
wait $PID

然后修改Dockerfile：

FROM mcr.microsoft.com/mssql/server:2019-latest

ENV MSSQL_SA_PASSWORD=Password123
ENV ACCEPT_EULA=Y

# 创建备份目录
RUN mkdir -p /var/opt/mssql/backup

# 复制备份文件和还原脚本
COPY ./AdventureWorks2022.bak /var/opt/mssql/backup/
COPY ./restore-db.sh /var/opt/mssql/

# 赋予脚本执行权限并执行还原
RUN chmod +x /var/opt/mssql/restore-db.sh && /var/opt/mssql/restore-db.sh

# 清理临时文件（可选，减小镜像体积）
RUN rm /var/opt/mssql/restore-db.sh /var/opt/mssql/backup/AdventureWorks2022.bak

关键优化点 #

• 安全优化：不要在Dockerfile中硬编码MSSQL_SA_PASSWORD，改用构建参数ARG或者运行时环境变量传入：

  ARG SA_PASSWORD
  ENV MSSQL_SA_PASSWORD=$SA_PASSWORD
  

  构建时用docker build --build-arg SA_PASSWORD=YourStrongPassword .
• 缓存利用：将备份文件复制和还原步骤分开，后续修改脚本时不需要重新复制备份文件，加快构建速度。
• 官方就绪检测：使用sqlcmd执行简单查询来判断服务是否就绪，比日志匹配更可靠。
• 镜像瘦身：还原完成后删除备份文件和脚本，减少镜像占用空间。
• 还原完整性：添加REPLACE覆盖同名数据库（如果存在），用NORECOVERY+RECOVERY确保还原流程完整。

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