{
  "id": "ros2/rosbag2-compression-format-mismatch",
  "signature": "rosbag2_storage: Failed to open bag: unsupported compression format 'zstd' for storage plugin 'sqlite3'",
  "signature_zh": "rosbag2存储：无法打开包：存储插件'sqlite3'不支持压缩格式'zstd'",
  "regex": "Failed to open bag: unsupported compression format 'zstd' for storage plugin 'sqlite3'",
  "domain": "ros2",
  "category": "data_error",
  "subcategory": null,
  "root_cause": "The rosbag2 sqlite3 storage plugin does not support zstd compression; only lz4 is supported by default, and custom plugins for zstd are not installed.",
  "root_cause_type": "generic",
  "root_cause_zh": "rosbag2的sqlite3存储插件不支持zstd压缩；默认只支持lz4，且未安装zstd的自定义插件。",
  "versions": [
    {
      "version": "ros2-humble",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "ros2-iron",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    },
    {
      "version": "ros2-rolling",
      "introduced": null,
      "deprecated": null,
      "removed": null,
      "behavior_change": null,
      "status": "active"
    }
  ],
  "os_specific": {},
  "dead_ends": [
    {
      "action": "",
      "why_fails": "Default sqlite3 plugin code doesn't support zstd; requires a separate plugin package.",
      "fail_rate": 0.8,
      "condition": "",
      "sources": []
    },
    {
      "action": "",
      "why_fails": "Environment variable alone doesn't install the required plugin; the plugin must be built and loaded.",
      "fail_rate": 0.9,
      "condition": "",
      "sources": []
    }
  ],
  "workarounds": [
    {
      "action": "Install the rosbag2_compression_zstd plugin: sudo apt install ros-humble-rosbag2-compression-zstd",
      "success_rate": 0.95,
      "how": "Install the rosbag2_compression_zstd plugin: sudo apt install ros-humble-rosbag2-compression-zstd",
      "condition": "",
      "sources": []
    },
    {
      "action": "Convert bag to lz4 compression: ros2 bag compress --input /path/to/bag --output /path/to/output --compression-queue-size 1 --compression-mode file --compression-format lz4",
      "success_rate": 0.9,
      "how": "Convert bag to lz4 compression: ros2 bag compress --input /path/to/bag --output /path/to/output --compression-queue-size 1 --compression-mode file --compression-format lz4",
      "condition": "",
      "sources": []
    }
  ],
  "workarounds_zh": [
    "安装rosbag2_compression_zstd插件：sudo apt install ros-humble-rosbag2-compression-zstd",
    "将包转换为lz4压缩：ros2 bag compress --input /path/to/bag --output /path/to/output --compression-queue-size 1 --compression-mode file --compression-format lz4"
  ],
  "transition_graph": {
    "leads_to": [],
    "preceded_by": [],
    "frequently_confused_with": []
  },
  "official_doc_url": "https://docs.ros.org/en/rolling/Tutorials/Advanced/Recording-A-Bag-With-Compression.html",
  "official_doc_section": null,
  "error_code": null,
  "verification_tier": "ai_generated",
  "confidence": 0.85,
  "fix_success_rate": 0.9,
  "resolvable": "true",
  "first_seen": "2024-03-10",
  "last_confirmed": "2024-06-01",
  "last_updated": "2024-06-01",
  "evidence_count": 1,
  "tags": [],
  "locale": "en",
  "aliases": []
}