How to fix Error: connect ECONNREFUSED 127.0.0.1:3306 in Node.js
Node.jsBEGINNERHIGHUpdated Dec 9, 2025· 141 views
Occurs when Node.js cannot establish a TCP connection to MySQL server because the server is not running, not listening on the specified port, or blocked by firewall.
Quick fix
Fixes ECONNREFUSED
- Fix step 1
node.js — error
# Error: connect ECONNREFUSED 127.0.0.1:3306Error: connect ECONNREFUSED 127.0.0.1:3306
What this error means
Placeholder meaning for ECONNREFUSED: Connection refused to MySQL. This error needs detailed documentation.
Typical symptoms
- Symptom 1
- Symptom 2
- Symptom 3
Common causes
- Cause 1
- Cause 2
- Cause 3
How to fix "Error: connect ECONNREFUSED 127.0.0.1:3306"
1Fix step 1
Placeholder fix instructions
Advanced notes
Placeholder advanced notes.
Frequently asked questions
- What does "ECONNREFUSED" mean?
- Placeholder meaning for ECONNREFUSED: Connection refused to MySQL. This error needs detailed documentation.
- How do I fix "ECONNREFUSED"?
- Occurs when Node.js cannot establish a TCP connection to MySQL server because the server is not running, not listening on the specified port, or blocked by firewall.
- What causes "ECONNREFUSED"?
- Cause 1 Cause 2 Cause 3
- Is the "ECONNREFUSED" error serious?
- Yes. This is a high-severity error that usually blocks work until it is fixed, but the steps above resolve it.
Official resources & further reading
- 📚Node.js Official Documentation
- 📖node-mysql2 GitHub - MySQL connection and error handling(Official Docs)
- 📖node-mysql2 documentation - connection configuration(Official Docs)
- 🐙
- 📝