如何在Linux Docker容器的SQL Server中还原bacpac文件搭建集成测试环境？

DevOps 小满

2026-5-15

解决Docker中SQL Server导入bacpac的问题

我来帮你梳理下这个场景的解决方案，结合你的需求（不需要数据持久化、基于bacpac运行测试）和技术背景，咱们一步步来：

核心问题：sqlpackage不在默认镜像里

你说得没错，官方的microsoft/mssql-server-linux镜像确实没有预装sqlpackage工具，所以咱们有两种可行的解决思路，我会分别说明并推荐最优方案。

方案1：使用独立的sqlpackage容器（推荐）

这个方案遵循Docker的单一职责原则，不需要修改原SQL Server镜像，维护起来更简单。咱们可以用微软官方的mcr.microsoft.com/mssql-tools镜像（里面包含sqlpackage），通过Docker Compose让它在SQL Server完全就绪后自动执行还原操作。

修改后的docker-compose.yml示例

version: '3'
services:
  projectweb:
    image: projectweb
    build:
      context: .
      dockerfile: Project\Dockerfile
    depends_on:
      - db
  db:
    image: "microsoft/mssql-server-linux:latest"
    environment:
      SA_PASSWORD: "MyVerySecurePassword"
      ACCEPT_EULA: "Y"
    volumes:
      - ./database:/tmp
    # 添加健康检查，确保SQL Server真正启动就绪
    healthcheck:
      test: ["CMD-SHELL", "/opt/mssql-tools/bin/sqlcmd -S localhost -U sa -P 'MyVerySecurePassword' -Q 'SELECT 1' || exit 1"]
      interval: 10s
      retries: 10
      start_period: 30s
  # 新增的bacpac还原服务
  restore-db:
    image: mcr.microsoft.com/mssql-tools
    # 等待db服务健康检查通过后再启动
    depends_on:
      db:
        condition: service_healthy
    volumes:
      - ./database:/tmp
    # 执行sqlpackage导入命令，替换成你的bacpac文件名和目标数据库名
    command: >
      /opt/mssql-tools/bin/sqlpackage
      /Action:Import
      /SourceFile:/tmp/your-database.bacpac
      /TargetServerName:db
      /TargetDatabaseName:YourTestDB
      /TargetUser:sa
      /TargetPassword:MyVerySecurePassword

关键说明：

健康检查（healthcheck）：单纯的depends_on只会等待容器启动，不会等SQL Server服务就绪。添加健康检查后，restore-db会等到SQL Server能正常响应查询时才执行还原，避免因服务未就绪导致的失败。
路径匹配：确保你的bacpac文件放在./database目录下，和volumes挂载的路径对应，同时在/SourceFile参数里填写正确的文件名。
版本兼容：如果你的bacpac是从特定版本的SQL Server导出的，建议把microsoft/mssql-server-linux:latest换成对应版本（比如2019-latest），避免版本不兼容问题。

方案2：自定义包含sqlpackage的SQL Server镜像

如果你的场景需要频繁复用这个带sqlpackage的SQL Server镜像，可以自己构建一个自定义镜像，把sqlpackage安装进去。

自定义Dockerfile示例

FROM microsoft/mssql-server-linux:latest

# 安装sqlpackage依赖
RUN apt-get update && \
    apt-get install -y unzip && \
    rm -rf /var/lib/apt/lists/*

# 下载并安装sqlpackage（注意链接是对应Linux版本的，可根据需要更新）
RUN curl -L -o sqlpackage.zip https://go.microsoft.com/fwlink/?linkid=2157202 && \
    unzip sqlpackage.zip -d /opt/sqlpackage && \
    chmod +x /opt/sqlpackage/sqlpackage && \
    rm sqlpackage.zip

# 把sqlpackage加入系统PATH
ENV PATH="$PATH:/opt/sqlpackage"

# 复制还原脚本到容器内
COPY restore-bacpac.sh /usr/src/restore-bacpac.sh
RUN chmod +x /usr/src/restore-bacpac.sh

# 启动SQL Server并执行还原脚本（需要后台启动SQL Server，执行脚本后等待）
CMD /opt/mssql/bin/sqlservr & /usr/src/restore-bacpac.sh && wait

对应的restore-bacpac.sh脚本

#!/bin/bash

# 等待SQL Server启动（可根据实际情况调整等待时间）
echo "Waiting for SQL Server to initialize..."
sleep 30s

# 执行bacpac导入
/opt/sqlpackage/sqlpackage \
  /Action:Import \
  /SourceFile:/tmp/your-database.bacpac \
  /TargetServerName:localhost \
  /TargetDatabaseName:YourTestDB \
  /TargetUser:sa \
  /TargetPassword:$SA_PASSWORD

优缺点：

优点：所有功能整合在一个容器里，不需要额外的服务。
缺点：构建镜像相对麻烦，且需要处理SQL Server启动和脚本执行的顺序（因为SQL Server默认是前台运行，需要后台启动后再执行脚本）。

最佳实践总结

优先选方案1：更符合Docker的设计理念，不需要修改原镜像，排查问题也更简单。
不要依赖单纯的depends_on：一定要用健康检查确保SQL Server服务就绪后再执行还原。
不需要持久化就别挂载数据卷到SQL Server的/data目录：这样容器销毁后数据会自动清除，完全符合你的测试需求。
注意bacpac的版本兼容性：确保SQL Server镜像版本和bacpac导出的版本匹配，避免还原失败。

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