PyDev 8.0.1环境下普通运行模式触发内置breakpoint()报连接被拒绝错误
问题场景与环境
- 设备与系统:macOS Big Sur 11.0.1 版本 MacBook Pro
- 开发栈版本:
- Python 3.7.8(Anaconda ch_dev37 虚拟环境)
- Eclipse 2020-09(4.17.0)
- PyDev 8.0.1
- 触发逻辑:点击Eclipse GUI上的*普通运行按钮(非调试模式启动)*执行Python代码时,代码内的内置
breakpoint()会触发PyDev的断点拦截逻辑,抛出端口连接拒绝错误,完整报错如下:
参考报错堆栈:
warning: Debugger speedups using cython not found. Run '"/Users/Work/opt/anaconda3/envs/ch_dev37/bin/python" "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/setup_cython.py" build_ext --inplace' to build. Could not connect to 127.0.0.1: 5678 Traceback (most recent call last): File "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/_pydevd_bundle/pydevd_comm.py", line 462, in start_client s.connect((host, port)) ConnectionRefusedError: [Errno 61] Connection refused Traceback (most recent call last): File "/Volumes/GoogleDrive/My Drive/free_energy_data/write_energies.py", line 111, in <module> write_gases, write_adsorbates, verbose) File "/Users/Work/opt/dev/gits/CatHub/cathub/catmap_interface.py", line 31, in write_energies breakpoint() File "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/pydev_sitecustomize/sitecustomize.py", line 74, in custom_sitecustomize_breakpointhook pydevd.settrace(*args, **kwargs) File "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/pydevd.py", line 2623, in settrace notify_stdin=notify_stdin, File "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/pydevd.py", line 2688, in _locked_settrace py_db.connect(host, port) # Note: connect can raise error. File "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/pydevd.py", line 1262, in connect s = start_client(host, port) File "/Applications/Eclipse.app/Contents/Eclipse/plugins/org.python.pydev.core_8.0.1.202011071328/pysrc/_pydevd_bundle/pydevd_comm.py", line 462, in start_client s.connect((host, port)) ConnectionRefusedError: [Errno 61] Connection refused
- 已知对照验证结果:
- 根据PyDev官方发布说明,PyDev 6.5.0 版本起就已支持Python内置
breakpoint()断点能力,理论上可正常使用 - 同环境下传统的
import pdb; pdb.set_trace()方式设置断点功能运行正常 - 脱离PyDev的终端环境下,内置
breakpoint()执行无任何问题 - 仅在PyDev环境的普通运行模式下触发内置断点时,才会出现上述连接拒绝报错
- 根据PyDev官方发布说明,PyDev 6.5.0 版本起就已支持Python内置
问题根因
这个异常是PyDev 8.0.1版本的全局钩子机制与普通运行模式的端口监听逻辑不匹配导致的:
- PyDev会通过
sitecustomize全局钩子,强制覆盖Python解释器内置的breakpoint()行为:只要代码执行到breakpoint(),就会自动调用pydevd.settrace()尝试连接Eclipse侧的调试服务端口(默认地址为127.0.0.1,端口5678)。 - 该全局钩子不会判断当前代码的运行模式:普通运行模式下,Eclipse本身不会启动对应的调试服务监听端口,只有切换到调试模式启动时,Eclipse才会在本地开启该端口等待Python调试进程的连接。
- 被篡改的
breakpoint()在普通运行模式下触发时,会硬连接无服务监听的端口,最终抛出连接拒绝异常。 - 同环境下
pdb.set_trace()功能正常,是因为该函数的拦截逻辑仅在调试模式下由PyDev主动注入,普通运行模式下不会强制覆盖其原生行为,可直接走Python自带的pdb调试流程。
解决方案
按操作便捷度排序:
- 关闭PyDev对内置
breakpoint()的全局自动拦截
打开Eclipse偏好设置,依次进入PyDev > Debug配置页,取消勾选 "Python break() builtin function is automatically handled by PyDev" 选项。调整后普通运行模式下的breakpoint()会回归原生Python的pdb行为,不会尝试连接不存在的调试端口;进入调试模式时,PyDev仍然会正常拦截breakpoint()触发断点,不影响调试使用。 - 需要联动PyDev调试能力时,直接使用调试模式启动代码
如果需要通过breakpoint()和PyDev调试能力联动,不要使用普通运行按钮,直接选择调试模式启动:此时Eclipse会提前在5678端口开启调试服务监听,breakpoint()触发时可正常建立连接进入调试状态。 - cython加速提示的处理
报错中的cython speedups提示仅为调试执行效率的优化提醒,不会影响核心功能,也不是连接拒绝问题的诱因。如果需要提升调试执行速度,可按照报错提示的命令,在对应Python虚拟环境下执行编译命令生成加速扩展即可。
内容的提问来源于stack exchange,提问作者Viswanath
相关产品推荐
相关产品推荐

