npm ERR! code EEXIST

What This Error Means

npm attempted to create a file that already exists (EEXIST).

How to Fix It

1. Identify the path npm is failing on (look for the last referenced file path in the error output).
2. Retry after cleaning local state when safe (common: remove node_modules and retry install).

Why It Happens

• The error output usually includes the path that failed, that path points to the real OS-level issue (permissions, disk, locks, or limits).

How to Verify

1. Re-run the original command and confirm the filesystem error no longer appears.
2. If this is a permission fix, confirm new files in node_modules are owned by the expected user.

Manual filesystem checks

1. Look for the last referenced filesystem path in the error output and validate that path exists and is writable.

Common CLI Output

npm ERR! code EEXIST

npm ERR! errno EEXIST

Prevention Tips

• Keep npm cache and project directories owned by the build user.
• Avoid running project installs as root unless you know exactly why you need it.
• Ensure CI runners have enough disk space and sensible file descriptor limits.

Where This Can Be Triggered

    try {
      await fs.mkdir(lockPath)
    } catch (err) {
      if (err.code !== 'EEXIST' && err.code !== 'EBUSY' && err.code !== 'EPERM') {
        throw err
      }