Connection refused — a firewall or proxy may be blocking it (ECONNREFUSED) · Ret...

🔍 错误翻译

原文：Connection refused — a firewall or proxy may be blocking it (ECONNREFUSED) · Retrying in 7s · attempt 5/10
译文：连接被拒绝 — 可能是防火墙或代理阻止了连接（ECONNREFUSED）· 7秒后重试 · 第5次尝试（共10次）

🎯 原因分析

根本原因：目标服务器主动拒绝了连接请求，常见于以下场景：

• 目标服务未启动或进程已崩溃，监听端口未开放


• 服务器的防火墙 / 代理规则拦截了来自客户端的连接


• 服务端绑定了特定 IP（如 127.0.0.1），客户端连接了错误地址

💡 解决方案

步骤 1：确认目标服务状态
在服务器上检查目标端口是否处于监听状态：

# Linux/macOS
ss -tlnp | grep <端口号>

# Windows
netstat -ano | findstr <端口号>

步骤 2：检查客户端连接配置
确保请求的地址和端口正确，没有被错误环境变量覆盖。批量重试应加入指数退避策略：

``代码语言
// Node.js 示例：带指数退避的重试机制
async function connectWithRetry(url, maxAttempts = 10) {
for (let attempt = 1; attempt <= maxAttempts; attempt++) {
try {
const res = await fetch(url, { timeout: 5000 });
return res;
} catch (err) {
if (err.code === 'ECONNREFUSED' && attempt < maxAttempts) {
const delay = Math.pow(2, attempt) * 1000; // 指数退避
console.error(连接被拒绝，${delay / 1000}秒后第${attempt + 1}次重试);
await new Promise(r => setTimeout(r, delay));
} else {
throw err; // 已达最大重试次数或非连接错误，直接抛出
}
}
}
}
`

🛡️ 预防措施

• 启用健康检查：在服务启动脚本中加入端口探测（如 nc -z `），确保服务可用后再让客户端发起请求，避免盲目重试。


• 配置合理的超时和重试：使用指数退避算法（如上述代码），不要让客户端频繁且密集地重试，给服务恢复留出缓冲时间，也能降低被防火墙判定为恶意流量的概率。