使用Python Bottle框架时Localhost无法连接，报ERR_CONNECTION_REFUSED错误

听起来你遇到了个挺闹心的状况——之前好好的Bottle本地服务突然罢工，连启动日志都没输出，换端口也不管用，浏览器直接报ERR_CONNECTION_REFUSED。我来帮你梳理几个实用的排查方向，一步步来定位问题：

1. 先确认Bottle依赖是否损坏 #

有时候Python依赖会莫名其妙出现文件损坏或版本冲突，哪怕你没装新程序也可能发生。试试重新安装Bottle，把旧的依赖清干净再装：

pip uninstall bottle -y && pip install bottle

安装完成后再运行你的代码，看看控制台有没有启动日志输出。

2. 检查Python环境是否意外切换 #

你说没装新程序，但可能不小心切换了Python环境？比如之前用的是虚拟环境，现在误操作用了系统全局的Python，或者反过来。先核对当前运行环境：

• 查看当前Python版本：python --version（或者python3，取决于你的系统配置）
• 检查该环境下的Bottle版本：pip show bottle
  如果发现环境不对，切换回原来的虚拟环境再测试。

3. 仔细核对代码的关键部分 #

哪怕你觉得没改代码，也可能出现误操作（比如不小心删了字符、改了下划线）。重点检查if __name__ == '__main__':这一行——双下划线不能写成单下划线，拼写也不能错，否则代码根本走不到run()方法。再贴一遍正确的核心代码对比：

from bottle import route, run, request, post, get, template
@route('/')
def index(): return "Hello World!"
if __name__ == '__main__':  # 这里的双下划线必须是两个
    run(host='localhost', port=8080, debug=True)

另外debug=True模式下本该输出详细日志，如果连这个都没动静，大概率代码没执行到启动服务的逻辑。

4. 测试极简版Bottle脚本 #

写个完全精简的脚本，排除其他导入模块的干扰，看看能不能正常启动：

from bottle import route, run
@route('/')
def hello():
    return "Hello World!"
run(host='localhost', port=8080, debug=True)

如果这个极简脚本能正常输出启动日志并访问，那问题可能出在你原代码的其他导入（比如request/template这些模块）上；如果还是没反应，那问题就出在Python环境或系统层面了。

5. 系统层面的排查 #

• 防火墙/安全软件拦截：有时候安全软件会突然把本地Python进程的网络请求拦截，哪怕是localhost的请求。试试临时关闭防火墙或安全软件，再重新运行服务测试。
• 进程挂起：运行代码后，打开任务管理器（Windows）或活动监视器（Mac），看看有没有Python进程在后台挂着。如果有，强制杀掉进程后再重新启动服务。
• 换host绑定试试：有时候localhost的解析可能出问题，把host改成0.0.0.0（绑定所有网络接口），然后用http://127.0.0.1:8080访问：

  run(host='0.0.0.0', port=8080, debug=True)
  

内容的提问来源于stack exchange，提问作者A95