✻ Connection refused — a firewall or proxy may be blocking it (ConnectionRefused...

🔍 错误分析

1. 🌐 错误翻译

原文：Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
译文：连接被拒绝 — 防火墙或代理可能阻止了连接（连接被拒绝）

2. 🎯 原因分析

根本原因：目标服务器拒绝了连接请求，通常是因为目标端口未开启、服务未运行，或防火墙/安全组规则阻止了访问

错误位置：发生在客户端尝试建立网络连接时，通常是在发起 HTTP、TCP 或其他网络请求的过程中

具体场景：常见于本地服务未启动、远程端口被拦截、Docker 容器端口未正确映射等情况

3. 💡 解决方案

排查与修复步骤：

确认目标服务状态：检查目标服务器上的服务是否已正常启动，并监听对应端口

检查端口可达性：

   # Linux/macOS
   telnet 目标IP 端口号
   # 或
   nc -zv 目标IP 端口号

   # Windows
   Test-NetConnection 目标IP -Port 端口号
   

检查防火墙/安全组：

- 本地防火墙：关闭临时防火墙测试（如 sudo ufw status、Windows 防火墙）
- 云服务器安全组：登录云平台控制台，添加对应端口的入站规则
- 容器环境：确认 Docker 端口映射正确（如 docker run -p 宿主机端口:容器端口）

验证服务监听：在目标服务器执行：

   # Linux/macOS
   netstat -tuln | grep 端口号
   # 或
   ss -tuln | grep 端口号

   # Windows
   netstat -ano | findstr "端口号"
   

若为本地开发服务未启动的修复示例（以Node.js为例）：

// 确保服务启动后再发起请求，例如先启动服务：
// 服务端代码（确保监听正确端口）
const express = require('express');
const app = express();
const port = 3000;

app.get('/api', (req, res) => {
  res.json({ message: 'Service is running' });
});

app.listen(port, '0.0.0.0', () => {
  console.log(`Server running at http://0.0.0.0:${port}`);
});

// 客户端请求（等待服务启动后再执行）
const https = require('https');
const options = {
  hostname: 'localhost',
  port: 3000,
  path: '/api',
  method: 'GET'
};

const req = https.request(options, (res) => {
  console.log(`statusCode: ${res.statusCode}`);
  res.on('data', (d) => process.stdout.write(d));
});

req.on('error', (e) => {
  console.error(e); // 若服务未启动，此处会报 Connection refused
});

req.end();

4. 🛡️ 预防措施

✅ 服务启动后再发起连接：在编写自动化脚本时，可添加服务启动检测（如循环检测端口是否可用）

✅ 明确端口和地址配置：区分本地回环地址（127.0.0.1）、局域网地址（192.168.x.x）、公网地址的监听范围，避免配置错误

✅ 使用工具快速排查：

- 推荐工具：telnet、nc（netcat）、netstat/ss（查看端口监听）、云平台自带的安全组诊断工具
- 接口测试工具：Postman 可直观显示连接状态，辅助排查网络问题