Docker部署MSSQL批量加载报错：文件不存在或无访问权限解决办法

DevOps 小满

2026-8-26

报错根因

Docker容器是与宿主机隔离的独立运行环境，存在独立的文件系统：

你在宿主机能正常通过cat @filepath访问目标文件，仅代表宿主机当前用户有该文件权限，不代表MSSQL容器内能看到、访问到这个文件
未做目录挂载时，容器内根本不存在宿主机上的目标文件；就算做了挂载，容器内MSSQL服务默认以UID=10001的mssql用户运行，若该用户无挂载目录的访问权限，也会触发报错
批量加载语句里如果填写的是宿主机侧的文件绝对路径，容器内无法识别该路径，同样会报文件不存在

解决步骤

停止并删除当前运行的MSSQL容器，先执行docker ps查询MSSQL对应的容器ID或名称，再执行以下命令清理：
```
docker stop <你的MSSQL容器ID/名称> && docker rm <你的MSSQL容器ID/名称>
```
单独在宿主机上新建一个专门存放批量导入文件的目录（不要放在/root或者个人用户的加密私有目录下），将需要导入的@file移动到该目录下，给目录授予容器内mssql用户的访问权限：
```
# 示例：新建目录为/opt/mssql_import，替换成你自己的实际目录路径即可
sudo mkdir -p /opt/mssql_import
sudo chown -R 10001:10001 /opt/mssql_import
```
重新启动MSSQL容器，添加目录挂载参数，将宿主机的导入文件目录映射到容器内的固定路径，示例启动命令：
```
docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=你设置的SA账号密码" \
   -p 1433:1433 \
   -v /opt/mssql_import:/var/opt/mssql/import \
   --name mssql \
   -d mcr.microsoft.com/mssql/server:2022-latest
```
注意：-v参数格式为宿主机目录绝对路径:容器内目录绝对路径，顺序不要写反。如果你的Ubuntu开了AppArmor安全规则，挂载参数可以改成-v /opt/mssql_import:/var/opt/mssql/import:z，给目录打上容器可访问的安全标签。
容器启动完成后，修改批量加载语句里的文件路径，必须填写容器内的映射路径，而非宿主机路径。比如宿主机上文件路径为/opt/mssql_import/data.csv，对应容器内路径就是/var/opt/mssql/import/data.csv，对应批量导入语句示例：
```
BULK INSERT 你的目标表名
FROM '/var/opt/mssql/import/data.csv'
WITH (
    -- 按需填写你自己的导入参数，比如字段分隔符、行分隔符、首行是否跳过等
    FIELDTERMINATOR = ',',
    ROWTERMINATOR = '\n',
    FIRSTROW = 2
);
```
可选验证：执行docker exec -it mssql bash进入容器终端，执行ls -l /var/opt/mssql/import，如果能看到你要导入的目标文件，且文件属主为mssql用户，说明权限和路径配置正确。

常见避坑点

不要将宿主机的/root目录、个人用户家目录下的私有子目录直接挂载给容器，这类目录默认权限严格，容器内服务大概率无访问权限
所有挂载路径必须写绝对路径，不要写./开头的相对路径
你之前连接MSSQL用localhost,1433的配置是正确的，只要端口映射正常不需要修改连接地址
如果临时测试不想调整目录权限，也可以用docker cp @filepath mssql:/var/opt/mssql/data/命令把文件直接复制到容器内MSSQL默认的数据目录下，然后批量加载路径填/var/opt/mssql/data/@file即可，这种方式不需要重启容器，但容器重建后文件会丢失，仅适合临时测试场景。

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