Mac下Docker Compose部署SQL Server启动失败求助

我之前在Mac上用Docker部署SQL Server时也踩过这个坑，你的问题根源主要是权限不匹配加上Docker for Mac的挂载特性导致的，具体来说：

SQL Server 2019容器默认以非root的mssql用户（UID 10001）运行，但你挂载的Mac本地目录默认权限只给了你的本地用户，容器内的mssql用户根本没有读写权限，所以启动时无法打开刚复制的master.mdf文件，就抛出了Error 87(The parameter is incorrect.)的错误。

另外你用named volume配合bind驱动的方式，在Mac上可能会因为VM和本地文件系统的兼容性问题，加重权限问题的影响。

下面是两种可行的解决方案：

方案一：直接挂载本地目录 + 调整权限（推荐） #

这个方法更直观，不需要复杂的volume配置：

1. 先清理之前的容器和残留volume：

docker compose down -v

2. 确保本地目标目录存在，并且设置开放权限（Mac上因为UID不匹配，直接给全权限最省心）：

mkdir -p /Users/rausch/Documents/docker-volumes/mssql/data
sudo chmod -R 777 /Users/rausch/Documents/docker-volumes/mssql/data

3. 修改你的Docker Compose配置，去掉多余的named volume定义，直接挂载本地目录：

version: '3'
services:
  sql1:
    image: "mcr.microsoft.com/mssql/server"
    ports:
      - 1433:1433
    environment:
      ACCEPT_EULA: Y
      SA_PASSWORD: 1sa!1234
      MSSQL_PID: Standard
    volumes:
      - /Users/rausch/Documents/docker-volumes/mssql/data:/var/opt/mssql

4. 重新启动容器：

docker compose up -d

方案二：临时用root用户启动（不推荐长期使用） #

如果你只是快速测试，可以临时让容器以root用户运行，绕开权限问题：
修改services.sql1部分，添加user: root：

services:
  sql1:
    image: "mcr.microsoft.com/mssql/server"
    ports:
      - 1433:1433
    environment:
      ACCEPT_EULA: Y
      SA_PASSWORD: 1sa!1234
      MSSQL_PID: Standard
    volumes:
      - /Users/rausch/Documents/docker-volumes/mssql/data:/var/opt/mssql
    user: root

注意：这个方法会降低容器的安全性，只适合测试场景。

为什么原来的配置会失败？ #

你原来的named volume绑定配置，虽然把本地目录挂载到了容器里，但容器内的mssql用户没有该目录的读写权限。Mac的本地文件系统（APFS）和Docker VM的Linux文件系统权限模型不兼容，直接用bind驱动无法自动同步权限，导致SQL Server无法访问自己复制过去的数据库文件。

验证方法 #

启动容器后，用以下命令查看日志确认是否正常运行：

docker compose logs -f

如果看到类似SQL Server is now ready for client connections.的日志，就说明成功了。

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