You need to enable JavaScript to run this app. PyDev 8.0.1环境下普通运行模式触发内置breakpoint()报连接被拒绝错误
优惠活动
大模型
产品
解决方案
定价
更多

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 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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.16 19:45:05