Error Codes Wiki

Disk Utility First Aid Failed — Mac Disk Repair and File System Error Recovery

Errordisk

Overview

Fix Disk Utility First Aid failures when the repair tool cannot fix APFS or HFS+ file system errors on Mac internal and external drives.

Key Details

  • First Aid checks and repairs file system directory structure, allocation tables, and metadata
  • It cannot repair the startup disk while macOS is running — use Recovery Mode for startup disk repair
  • APFS (Apple File System) and HFS+ (Mac OS Extended) have different repair capabilities
  • First Aid may report errors it cannot fix — more serious issues require Recovery Mode or reformatting
  • External drives should be safely ejected to prevent file system corruption

Common Causes

  • File system corruption from improper disk ejection, power loss, or hardware failure
  • Startup disk cannot be fully repaired while macOS is booted from it
  • Physical drive failure causing unrecoverable file system damage
  • APFS container or volume corruption beyond automated repair capabilities

Steps

  1. 1Try First Aid from Recovery Mode: restart into Recovery > Disk Utility > select the volume > First Aid
  2. 2If First Aid fails on startup disk: boot from external macOS installer or Recovery to repair
  3. 3Run 'fsck_apfs -y /dev/diskXsY' or 'fsck_hfs -fy /dev/diskXsY' from Terminal in single-user or Recovery mode
  4. 4For external drives: try First Aid on the container first, then individual volumes
  5. 5If repair fails: back up readable data using Terminal commands, then erase and reformat the drive

Tags

disk-utilityfirst-aidrepairapfsfile-system

Related Items

More in Disk

Frequently Asked Questions

Only partially while booted from it. For full repair, boot into Recovery Mode (Cmd+R on Intel, hold power on Apple Silicon) and run First Aid from there. Recovery Mode unmounts the startup disk for complete access.