Docker运行SQL Server容器启动即退出，请求解析错误日志并排查

错误解析 #

日志核心问题是SQL Server无法读取/var/opt/mssql/.system/instance_id文件，该文件是实例初始化时生成的关键标识文件，缺失会直接导致平台抽象层（PAL）初始化失败，最终容器启动后自动退出。

排查步骤 #

• 验证基础镜像可用性
  先排除镜像本身问题，启动一个不挂载自定义卷的容器测试：

  docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=YourStrongPass123" -d mcr.microsoft.com/mssql/server:2019-latest
  

  若该容器能正常运行，说明问题出在你挂载的自定义卷上。

• 修复自定义卷的目录结构

  1. 若卷中无重要数据，直接删除卷重新初始化：

     docker volume rm <你的卷名称>
     # 重新启动容器并挂载新卷
     docker run -v <卷名称>:/var/opt/mssql -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=YourStrongPass123" -d mcr.microsoft.com/mssql/server:2019-latest
     

  2. 若卷中有需保留的数据，手动创建缺失目录并修正权限：
     • 通过docker inspect <卷名称>查看宿主机上卷的实际路径（Mountpoint字段）
     • 执行以下命令：

       mkdir -p <卷实际路径>/.system
       chown 10001:10001 <卷实际路径>/.system  # mssql用户默认UID/GID为10001
       chmod 700 <卷实际路径>/.system
       

• 检查容器启动参数

  • 确认未错误设置MSSQL_DATA_DIR等环境变量，避免SQL Server指向错误路径
  • 检查启动命令中是否有--user参数冲突，确保运行用户为mssql

• 排查文件系统兼容性
  若使用WSL2挂载Windows目录、NFS或其他远程存储，可能存在权限或文件系统特性不兼容。尝试将卷挂载到本地宿主机目录，或调整WSL2的文件权限配置（如修改/etc/wsl.conf启用元数据）

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