Python连接被拒绝错误ConnectionRefuedError解决方法

答案是服务未运行、端口错误或防火墙限制导致连接被拒绝，需检查服务状态、确认IP与端口匹配、排查防火墙及绑定地址设置。

当使用Python进行网络编程或请求远程服务时，经常会遇到 ConnectionRefusedError: [Errno 111] Connection refused 错误。这个错误表示客户端尝试连接服务器时，目标主机明确拒绝了连接。以下是常见原因和对应的解决方法。

检查目标服务是否正在运行

最常见的原因是目标服务器上的服务没有启动。例如，你在本地尝试连接Redis、MySQL或一个自定义的Socket服务，但对应的服务进程未运行。

解决方法：

• 确认你要连接的服务（如Web服务器、数据库等）已经启动。
• 以Flask应用为例，确保已执行 app.run() 并监听正确的地址和端口。
• 对于本地服务，可通过命令查看进程是否存在，如：ps aux | grep python 或 systemctl status mysqld。

确认IP地址和端口号正确

连接时使用的IP或端口错误，会导致连接被拒绝。比如服务监听在 127.0.0.1:8000，但你尝试连接 localhost:8080。

立即学习“Python免费学习笔记（深入）”；

建议做法：

LSP Python

利用 pylsp 进行 Python 代码质量检查与 LSP 集成。提供代码诊断、补全、悬停提示及风格分析。适用于检查 Python 代码质量、获取补全建议及风格优化。

下载

• 检查服务实际监听的地址和端口，可用命令：netstat -tuln | grep :端口号 或 lsof -i :端口号。
• 确保客户端代码中使用的host和port与服务端一致。
• 注意 127.0.0.1 和 localhost 通常等价，但某些配置下可能有差异。

防火墙或安全组限制

操作系统防火墙或云服务器的安全组策略可能阻止了端口访问。

排查步骤：

• 临时关闭防火墙测试（不推荐生产环境）：sudo ufw disable 或 sudo systemctl stop firewalld。
• 添加允许规则，如：sudo ufw allow 8000。
• 云服务器（如AWS、阿里云）需检查安全组是否放行对应端口。

服务绑定地址问题

有些服务默认只绑定到 127.0.0.1，无法从外部访问。例如Flask默认只监听本地。

解决方案：

• 修改服务绑定地址为 0.0.0.0，使其监听所有网络接口。
• 例如启动Flask应用时使用：app.run(host=0.0.0.0, port=5000)。
• 确保服务配置文件中没有限制绑定IP。

基本上就这些。连接被拒绝多数是服务没开、端口不对或网络策略拦住。按顺序查一遍，问题通常能快速定位。