Linux环境下Docker容器外部文件读取权限问题排查

一、确保Docker Compose卷挂载配置正确 #

宿主机文件路径为/root/Deployment/Connector/files/，需将其挂载到容器内的一个明确路径（比如/app/files），必须使用绝对路径，不能用相对路径。以下是正确的docker-compose.yaml配置示例：

version: '3.8'
services:
  dotnet-connector:
    image: your-dotnet-app-image:latest
    volumes:
      # 宿主机路径:容器内挂载路径
      - /root/Deployment/Connector/files/:/app/files/
    environment:
      # 通过环境变量传递容器内路径，避免硬编码
      - APP_FILES_DIR=/app/files

二、解决权限拒绝问题（System.UnauthorizedAccessException） #

Linux下/root目录默认权限为700，仅root用户可访问，而Docker容器通常以非root用户运行（如官方.NET镜像的appuser），导致容器进程无权限读取挂载目录。可通过两种方式解决：

方法1：调整宿主机目录权限（推荐） #

给宿主机目标目录添加容器进程可访问的权限，或者修改目录所属用户/组：

# 临时开放全权限（应急用，不推荐长期）
chmod -R 777 /root/Deployment/Connector/files/

# 更安全的方式：先查看容器内运行用户的UID/GID
docker exec -it dotnet-connector id
# 假设返回UID=1000，GID=1000，修改目录归属
chown -R 1000:1000 /root/Deployment/Connector/files/

方法2：容器以root用户运行（不推荐，降低安全性） #

在docker-compose.yaml中添加user: root：

services:
  dotnet-connector:
    ...
    user: root
    ...

三、.NET代码中正确读取路径 #

容器内无法直接访问宿主机的/root路径，必须使用容器内的挂载路径，优先通过环境变量获取，避免硬编码：

// 从环境变量读取配置路径，默认值兜底
string filesDir = Environment.GetEnvironmentVariable("APP_FILES_DIR") ?? "/app/files";

// 读取JSON文件
string configPath = Path.Combine(filesDir, "settings.json");
string configContent = File.ReadAllText(configPath);

// 初始化LiteDB
string dbPath = Path.Combine(filesDir, "appdata.db");
using var db = new LiteDatabase(dbPath);

使用Path.Combine自动适配Linux的路径分隔符/，避免手动拼接出错。

四、排查步骤 #

若问题仍存在，按以下步骤定位：

1. 确认宿主机目录存在且有目标文件：ls -l /root/Deployment/Connector/files/
2. 进入容器验证挂载是否生效：docker exec -it dotnet-connector ls /app/files
3. 查看容器内运行用户：docker exec -it dotnet-connector whoami
4. 查看容器日志定位具体错误：docker logs dotnet-connector

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