How to Fix ‘Google Drive: An Unknown Issue Occurred and Needs to Quit’

Launching Google Drive for Desktop on Windows or macOS only to receive the fatal crash dialogue: ‘An unknown issue occurred and Google Drive needs to quit’ disrupts scheduled file synchronisation and local cloud folder access. Clicking ‘Quit’ terminates the background sync daemon immediately, leaving local files unsynchronized and offline mirrors inaccessible. This unrecoverable crash occurs when Google Drive encounters a corrupted local metadata database (SQLite), conflicting virtual drive letter bindings, permission locks in the user AppData/Application Support directory, or damaged OAuth2 authentication tokens.

Why Google Drive for Desktop Crashes on Launch

Google Drive for Desktop creates a virtual filesystem mount (virtual drive letter on Windows or FUSE/CloudStorage volume on macOS). Common failure triggers include:

  • Corrupted SQLite Metadata Database: The local tracking database (cloud_graph) recording file version hashes and synchronisation states becoming corrupted after a system freeze or hard shutdown.
  • Virtual Mount Drive Letter Collisions: Windows attempting to mount Google Drive to a drive letter (such as G:) already assigned to an internal partition, USB drive, or network share.
  • Stale Proxy and Credential Tokens: Damaged authentication tokens stored in the system credential manager preventing the desktop agent from negotiating secure API access.
  • Antivirus File Lock Conflicts: Endpoint security suites locking Google Drive database journal files during active synchronisation passes.

Step 1: Terminate Hung Google Drive Background Tasks

If background child threads remain hung in memory, launching a new instance creates an immediate thread collision crash.

  1. On Windows 11: Press Ctrl + Shift + Esc to open Task Manager. Look for all instances of Google Drive or GoogleDriveFS.exe, right-click each, and select End task.
  2. On macOS: Press Cmd + Space, type Activity Monitor, search for Google Drive, select the process, and click the stop (X) icon to force-quit.

Step 2: Clear Corrupted Local Cloud Graph Cache

Deleting the corrupted local SQLite metadata cache forces Google Drive to rebuild a fresh, pristine index of your cloud files without deleting files from the cloud.

  1. Ensure Google Drive is completely closed.
  2. Navigate to the local application data directory:
    • Windows: Press Win + R, type %LOCALAPPDATA%\Google\DriveFS, and press Enter.
    • macOS: In Finder, press Cmd + Shift + G and enter:
      ~/Library/Application Support/Google/DriveFS
  3. Inside the DriveFS directory, locate the folder named with your 21-digit Google account number (or select the entire folder contents).
  4. Rename the folder to DriveFS.old (or delete temporary cache files).
  5. Relaunch Google Drive. The application will prompt you to authenticate your Google account and reconstruct the local cloud database cleanly.

Step 3: Change Virtual Drive Letter Mount (Windows)

If a physical USB thumb drive or network partition claimed the default drive letter, reassigning the mount point resolves the launch exception.

  1. Click the Google Drive icon in the system notification tray (near the clock).
  2. Click the Settings (gear) icon and select Preferences.
  3. Click the secondary Settings (gear) icon in the top-right corner of the Preferences window.
  4. Scroll down to the section titled Google Drive streaming location.
  5. Under Drive letter, click the dropdown menu and select an unassigned letter from the bottom of the alphabet (such as X:, Y:, or Z:).
  6. Click Save and restart Google Drive when prompted.

Step 4: Reinstall Google Drive for Desktop

If core executable binaries or virtual filesystem driver hooks were damaged during an interrupted update, clean reinstallation restores system integrity.

  1. Open Windows Settings > Apps > Installed apps (or drag Google Drive to the Trash on Mac).
  2. Select Google Drive and click Uninstall.
  3. Restart your computer.
  4. Visit the official Google website to download the latest installer package for Google Drive for Desktop.
  5. Run the installer with administrative privileges to restore all virtual filesystem drivers.

Get the best tech tips delivered straight to your inbox.

Join thousands of readers mastering Apple, Google, Microsoft, and Linux.