DEV Community

Kyle Y. Parsotan
Kyle Y. Parsotan

Posted on

🚨 Common React & npm Bugs (and How to Fix Them Like a Pro)

#webdev #tutorial #productivity #opensource

Every developer hits weird errors. The difference between struggling for hours vs fixing things fast comes down to pattern recognition.

This post breaks down well-known bugs, why they happen, and how to fix them quickly—especially in projects using Create React App and the Node ecosystem.

🧨 1. react-scripts: command not found

❌ Error 

sh: react-scripts: command not found
Enter fullscreen mode Exit fullscreen mode

💥 Why it happens

  • react-scripts isn’t installed
  • node_modules is missing/corrupted
  • Wrong project directory

✅ Fix 

rm -rf node_modules package-lock.json
npm install
Enter fullscreen mode Exit fullscreen mode

If still broken:

npm install react-scripts
Enter fullscreen mode Exit fullscreen mode

🔐 2. EACCES Permission Denied

❌ Error 

EACCES: permission denied, mkdir 'node_modules/.cache'
Enter fullscreen mode Exit fullscreen mode

💥 Why it happens

  • You used sudo npm install
  • Files are owned by root

✅ Fix 

sudo chown -R $(whoami) .
rm -rf node_modules package-lock.json
npm install
Enter fullscreen mode Exit fullscreen mode

🚫 Never use:

sudo npm install
Enter fullscreen mode Exit fullscreen mode

📦 3. node_modules Hell (Corrupted installs)

❌ Symptoms

  • Random errors after install
  • Missing packages
  • App won’t start

💥 Why it happens

  • Interrupted installs
  • Lockfile conflicts
  • Cache issues

✅ Fix (golden reset) 

rm -rf node_modules package-lock.json
npm cache clean --force
npm install
Enter fullscreen mode Exit fullscreen mode

⚠️ 4. Version Mismatch (Node issues)

❌ Symptoms

  • Packages fail to install
  • Build crashes
  • Strange syntax errors

💥 Why it happens

Some tools don’t support newer Node versions.

✅ Fix 

node -v
Enter fullscreen mode Exit fullscreen mode

Use:

  • Node 18 or 20

Use a version manager if needed.

🔄 5. Mixing Package Managers

❌ Symptoms

  • Duplicate dependencies
  • Lockfile conflicts
  • Install failures

💥 Why it happens

Using npm + yarn together.

✅ Fix

  • Use ONE:

    • package-lock.json → npm
    • yarn.lock → yarn

🌐 6. Port Already in Use

❌ Error 

Something is already running on port 3000
Enter fullscreen mode Exit fullscreen mode

💥 Why it happens

Another process is using the port.

✅ Fix 

lsof -i :3000
kill -9 <PID>
Enter fullscreen mode Exit fullscreen mode

🧪 7. ESLint Permission Errors

❌ Error 

EACCES: permission denied
Enter fullscreen mode Exit fullscreen mode

💥 Why it happens

Same root cause: ownership issues.

✅ Fix 

sudo chown -R $(whoami) .
Enter fullscreen mode Exit fullscreen mode

⚡ 8. Module not found Errors

❌ Error 

Module not found: Can't resolve 'xyz'
Enter fullscreen mode Exit fullscreen mode

💥 Why it happens

  • Package not installed
  • Wrong import path
  • Case-sensitive file systems

✅ Fix 

npm install xyz
Enter fullscreen mode Exit fullscreen mode

Or fix import:

import Component from "./Component" // not ./component
Enter fullscreen mode Exit fullscreen mode

🔥 9. Environment Variables Not Working

❌ Symptoms

  • process.env is undefined

💥 Why it happens

In CRA, env vars must start with:

REACT_APP_
Enter fullscreen mode Exit fullscreen mode

✅ Fix 

REACT_APP_API_URL=https://api.com
Enter fullscreen mode Exit fullscreen mode

Restart dev server after changes.

🧠 10. Outdated Tooling Problems

❌ Symptoms

  • Random build errors
  • Slow dev server
  • Weird dependency issues

💥 Why it happens

Older tools like Create React App rely on aging dependencies.

🚀 Modern Fix (Long-Term)

Instead of constantly patching bugs:

Switch to:

  • ⚡ Vite
  • 🔥 Next.js

Example (Vite setup) 

npm create vite@latest my-app
cd my-app
npm install
npm run dev
Enter fullscreen mode Exit fullscreen mode

👉 Faster, fewer bugs, better DX.

🧠 Final Thoughts

Most “React bugs” are actually:

⚙️ environment problems, not code problems

Once you recognize patterns like:

  • permissions
  • missing dependencies
  • version mismatches

You’ll debug 10x faster.

💬 What bug are you stuck on?

Drop your error below 👇
I’ll help you debug it step-by-step.

Top comments (0)