Kubernetes NFS存储的/etc/exports正确配置及SQL容器I/O错误排查

错误信息翻译 #

[S0002][823] com.microsoft.sqlserver.jdbc.SQLServerException: 操作系统在读取文件 '/var/opt/mssql/data/master.mdf' 的偏移量0x0000000009a000位置时，向SQL Server返回错误1117(由于I/O设备错误，无法执行请求)。SQL Server错误日志和操作系统错误日志中的其他消息可能提供更多详细信息。这是严重的系统级错误情况，会威胁数据库完整性，必须立即纠正。请完成完整的数据库一致性检查(DBCC CHECKDB)。此错误可能由多种因素导致；更多信息请参阅SQL Server联机丛书。

/etc/exports配置优化 #

当前配置缺少数据库场景关键参数，建议修改为：

/srv     *(rw,no_subtree_check,no_root_squash,no_wdelay,fsid=0,insecure_locks)

参数说明：

• no_wdelay：禁用写延迟，避免NFS缓存写操作导致SQL Server写入时序异常
• fsid=0：将/srv设为NFS根目录，规避子目录挂载的元数据问题
• insecure_locks：允许非特权端口发起锁请求，适配容器内SQL Server进程的锁操作逻辑

修改后执行以下命令生效：

exportfs -ra
systemctl restart nfs-server

磁盘读写能力排查 #

SQL Server对存储IOPS、延迟敏感，NFS性能不足会触发I/O错误，执行以下排查：

• 在NFS服务器测试裸盘写入性能：

  dd if=/dev/zero of=/srv/test bs=1M count=1024 oflag=direct
  

  要求写入速度不低于100MB/s，同时用iostat -x 1观察磁盘使用率、延迟指标
• 在Kubernetes节点挂载NFS目录后，重复上述dd测试，确认网络传输无瓶颈
• 切换NFS版本至v4.1，修改nfs-subdir-external-provisioner的Helm配置，指定nfs.version=4.1，v4版本在锁机制、性能上更适配数据库场景

Kubernetes配置调整 #

1. PVC补充volumeMode配置：

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: mssql-data
   spec:
     storageClassName: nfs-client
     accessModes:
       - ReadWriteOnce
     volumeMode: Filesystem
     resources:
       requests:
         storage: 50Gi
   

2. Deployment完善安全上下文：
   确保容器进程以SQL Server用户身份运行，避免权限冲突：

   securityContext:
     runAsUser: 10001
     fsGroup: 10001
   

3. 检查PVC目录权限：
   在NFS服务器查看自动生成的PVC目录权限：

   ls -ld /srv/<PVC对应的子目录>
   

   确保目录所有者为10001:10001，否则执行chown -R 10001:10001 /srv/<PVC子目录>修正

额外排查步骤 #

• 查看SQL Server容器日志：kubectl logs -f <mssql-pod名称>，获取启动阶段的详细错误
• 查看NFS服务器日志：journalctl -u nfs-server，检查是否有锁请求失败、权限拒绝记录
• 查看节点NFS客户端日志：journalctl -u nfs-client.target，排查挂载或I/O超时问题

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