重启设备后Jupyter Lab/Notebook报localhost refused to connect错误如何解决

• localhost 主机映射异常：优先尝试直接访问日志中给出的完整IP地址链接http://127.0.0.1:8888/lab?token=5d46ff341e4b13023e47b6675ac0a7e45b4a51fcbe1c3eed，如果可以正常访问，说明系统hosts文件中localhost的指向被意外修改，修正hosts配置即可。
• 8888端口被残留进程占用：上次关机时Jupyter进程未正常退出，残留进程占用了8888端口，导致新启动的服务实际未正常监听该端口。Linux/macOS环境执行lsof -i:8888、Windows环境执行netstat -ano | findstr "8888"查看端口占用进程，杀掉残留进程后重启Jupyter即可恢复。
• 插件版本兼容冲突：你安装的jupyter_contrib_nbextensions插件和当前运行的Jupyter Server 1.11.1版本存在兼容问题，首次配置后临时生效，重启后配置加载逻辑异常导致服务假启动（终端日志正常但未实际监听端口）。可以临时重命名~/.jupyter配置目录后重启服务，排查是否为插件配置导致的问题。
• WSL 端口映射异常：从日志中的工作目录/mnt/c/可以判断你在WSL环境中运行Jupyter，WSL的网络适配在系统重启后经常出现端口映射失效问题，宿主机无法访问WSL内部监听的端口。可以在Windows终端执行wsl --shutdown关闭WSL后重新启动，或者启动Jupyter时指定监听所有地址jupyter lab --ip=0.0.0.0，再用WSL的实际IP加端口访问。
• 浏览器代理/缓存问题：浏览器开启全局代理会导致localhost请求被转发到外部网络无法连通，或者浏览器缓存了异常的访问状态，可尝试关闭代理、切换无痕模式访问排查。

内容的提问来源于stack exchange，提问作者amzon-ex