Docker容器中Sqlpackage工具定位及权限问题排查

问题1：/home/mssql/localtools/sqlpackage: not found #

这个报错本质是sqlpackage无法正常被识别，常见原因包括：

• 下载了Windows版本的sqlpackage到Linux容器中
• 解压后的文件路径配置错误
• 缺少sqlpackage运行依赖的系统库

修正方案 #

确保下载对应Linux x64版本的sqlpackage，安装必要依赖并正确解压：

# 基于官方SQL Server Linux镜像
FROM mcr.microsoft.com/mssql/server:2022-latest

# 安装sqlpackage运行依赖
RUN apt-get update && apt-get install -y \
    libunwind8 \
    libicu-dev \
    && rm -rf /var/lib/apt/lists/*

# 创建指定目录并下载解压Linux版sqlpackage
RUN mkdir -p /opt/sqlpackage \
    && curl -L https://aka.ms/sqlpackage-linux | tar -xvf - -C /opt/sqlpackage

# 验证文件是否存在（可选，用于调试）
RUN ls -la /opt/sqlpackage/sqlpackage

问题2：/tmp/sqlpackage/sqlpackage: Permission denied #

这个报错是因为sqlpackage二进制文件无执行权限，或者运行操作的mssql用户没有对应目录的访问权限。

修正方案 #

添加执行权限并确保mssql用户拥有目录访问权：

# 下载并解压sqlpackage到/tmp/sqlpackage
RUN mkdir -p /tmp/sqlpackage \
    && curl -L https://aka.ms/sqlpackage-linux | tar -xvf - -C /tmp/sqlpackage \
    # 给sqlpackage添加执行权限
    && chmod +x /tmp/sqlpackage/sqlpackage \
    # 将目录权限转移给mssql用户
    && chown -R mssql:mssql /tmp/sqlpackage

# 切换到mssql用户执行后续操作
USER mssql

# 启动SQL Server并部署dacpac的示例脚本
CMD /opt/mssql/bin/sqlservr & \
    # 等待SQL Server完全启动（根据实际情况调整时长）
    sleep 30 \
    # 执行dacpac发布
    /tmp/sqlpackage/sqlpackage /Action:Publish /SourceFile:/app/your-db.dacpac /TargetServerName:localhost /TargetDatabaseName:YourDB /TargetUser:sa /TargetPassword:$SA_PASSWORD \
    # 保持容器进程运行
    wait

额外注意事项 #

• 必须下载Linux x64版本的sqlpackage，避免跨平台版本不兼容
• 依赖库安装不可省略，否则会出现“文件找不到”的伪报错（实际是依赖缺失导致无法运行）
• 部署dacpac前要确保SQL Server完全启动，可根据容器性能调整等待时长
• 所有涉及文件操作的步骤，需保证mssql用户拥有对应权限

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