{
  "id": "docker/overlay2-mount-invalid-argument",
  "signature": "Error response from daemon: error creating overlay mount to /var/lib/docker/overlay2/...: invalid argument",
  "signature_zh": "来自守护进程的错误响应：创建 overlay 挂载到 /var/lib/docker/overlay2/... 时出错：无效参数",
  "regex": "error creating overlay mount to .*overlay2.*: invalid argument",
  "domain": "docker",
  "category": "system_error",
  "subcategory": null,
  "root_cause": "The filesystem backing Docker's storage (e.g., ext4 without 'overlay' feature or XFS without 'd_type' support) does not support the overlay2 driver requirements.",
  "root_cause_type": "generic",
  "root_cause_zh": "Docker 存储后端文件系统（如未启用 'overlay' 特性的 ext4 或缺少 'd_type' 支持的 XFS）不支持 overlay2 驱动要求。",
  "versions": [
    {
      "version": "Docker 25.0.3",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "Linux 6.1.0",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "ext4 1.46.5",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "Reinstall Docker completely",
      "why_fails": "Reinstallation does not change the underlying filesystem configuration; the mount error persists.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    },
    {
      "action": "Change storage driver to 'devicemapper' via daemon.json",
      "why_fails": "Devicemapper is deprecated and may cause other errors; also requires loop device setup.",
      "fail_rate": 0.6,
      "condition": "",
      "sources": []
    },
    {
      "action": "Run 'docker system prune -a' to clean storage",
      "why_fails": "Pruning removes data but does not fix the filesystem incompatibility for new mounts.",
      "fail_rate": 0.75,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Check filesystem support: run 'mount | grep overlay' and verify 'd_type' is enabled on XFS with 'xfs_info /var/lib/docker'. If missing, reformat the partition with 'mkfs.xfs -n ftype=1 /dev/sdX' (backup first).",
      "success_rate": 0.85,
      "how": "Check filesystem support: run 'mount | grep overlay' and verify 'd_type' is enabled on XFS with 'xfs_info /var/lib/docker'. If missing, reformat the partition with 'mkfs.xfs -n ftype=1 /dev/sdX' (backup first).",
      "condition": "",
      "sources": []
    },
    {
      "action": "Switch to 'vfs' storage driver temporarily by adding '{\"storage-driver\":\"vfs\"}' to /etc/docker/daemon.json and restarting Docker. Note: VFS uses more disk space.",
      "success_rate": 0.7,
      "how": "Switch to 'vfs' storage driver temporarily by adding '{\"storage-driver\":\"vfs\"}' to /etc/docker/daemon.json and restarting Docker. Note: VFS uses more disk space.",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "检查文件系统支持：运行 'mount | grep overlay'，并在 XFS 上使用 'xfs_info /var/lib/docker' 验证 'd_type' 是否启用。如果缺失，使用 'mkfs.xfs -n ftype=1 /dev/sdX' 重新格式化分区（需先备份）。",
    "临时切换到 'vfs' 存储驱动，在 /etc/docker/daemon.json 中添加 '{\"storage-driver\":\"vfs\"}' 并重启 Docker。注意：VFS 会占用更多磁盘空间。"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.docker.com/storage/storagedriver/overlayfs-driver/#prerequisites",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.88,
  "fix_success_rate": 0.82,
  "resolvable": "true",
  "first_seen": "2023-11-10",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}