K8s Pod挂载持久卷运行Django报sqlite3无法打开数据库错误

你遇到的报错核心来自3个配置错误，按优先级排序如下：

• 直接使用subPath挂载单个文件/app/db.sqlite3：当PVC初始为空时，Kubernetes会默认将subPath对应的路径创建为目录而非文件，Django尝试打开目录作为数据库文件，直接触发unable to open database file错误。
• initContainer数据写入逻辑错误：你执行migrate生成的数据库文件没有写入PVC，initContainer退出后数据丢失，主容器无法读取到有效的数据库文件。
• 权限修改范围有误：你执行chmod -R 777 /app修改的是容器镜像内置的/app目录权限，没有覆盖挂载到PVC的路径，权限配置不生效。

1. 调整Django数据库路径 #

修改Django项目settings.py中数据库配置，将sqlite文件存放路径改为单独的子目录，避免直接挂载单文件：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.sqlite3',
        'NAME': os.path.join(BASE_DIR, 'data/db.sqlite3'),
    }
}

重新构建应用镜像，可提前在镜像中创建/app/data空目录。

2. 修正Deployment配置 #

修改后的核心配置片段如下：

spec:
  # 可移除privileged权限，普通用户运行更安全，fsGroup会自动处理PVC权限
  securityContext:
    runAsUser: 1000
    runAsGroup: 1000
    fsGroup: 1000
    fsGroupChangePolicy: "OnRootMismatch"
  containers:
  - name: notation
    image: myimage
    imagePullPolicy: Always
    command: ["bash", "-c", "python ./manage.py runserver 0.0.0.0:8000"]
    ports:
    - containerPort: 8000
      name: http
    volumeMounts:
      - name: myapp-data
        # 直接挂载整个数据目录，不使用subPath
        mountPath: /app/data
  initContainers:
  - name: sqlite-data-permission-fix
    image: myimage
    # 先操作挂载的PVC目录，再执行迁移
    command: ["bash","-c","python ./manage.py migrate && envdir ./notation/.devenv python manage.py collectstatic"]
    volumeMounts:
      - name: myapp-data
        mountPath: /app/data
  volumes:
    - name: myapp-data
      persistentVolumeClaim:
        claimName: notation

如果你需要持久化静态文件，可将collectstatic的输出路径也配置到/app/data目录下，或者单独新增PVC挂载静态文件路径。

3. 验证效果 #

重新apply Deployment后，进入运行的Pod查看/app/data路径下是否生成了db.sqlite3文件，权限为配置的运行用户组可读写即可正常运行。

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