Hacktoberfest 2026:维护者为十月标记出来的 issue,仍然开放、适合新手。 浏览 Hacktoberfest issue

Python plugin fails with debugpy 1.8.16 - timeout during adapter connection

未关闭
#460 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
42/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
停滞
技术栈
python
领域
testing-qa

调研方向

The reported failure points to the Python plugin’s start.py, where debugpy.listen() is called, and compares debugpy 1.8.16 with 1.8.15. Read that call and check the plugin’s debugpy dependency requirements, then reproduce with both versions using the listed Gauge command. Done means debugging connects successfully with debugpy 1.8.16 or the supported version constraint is clear.

由索引模型根据 Issue 内容生成。

描述

bug help wanted

Python plugin fails with debugpy 1.8.16 - timeout during adapter connection

Environment

  • Gauge version: 1.6.21 (Commit Hash: 7d3f2cf)
  • Gauge plugins: html-report (4.3.3), json-report (0.5.2), python (0.4.11), screenshot (0.3.2)
  • VS Code Gauge extension: v0.2.3
  • debugpy version: 1.8.16 (broken), 1.8.15 (works)
  • Python version: 3.12.11
  • OS: Windows

Description

When running Gauge specs with debugpy 1.8.16, the Python plugin consistently fails with a timeout error during debugpy adapter connection. The plugin's start.py calls debugpy.listen() but the adapter connection times out. Downgrading to debugpy 1.8.15 resolves the issue completely.

This appears to be a compatibility issue between Gauge Python plugin and the latest debugpy version.

Steps to Reproduce

  1. Install debugpy 1.8.16: pip install debugpy==1.8.16
  2. Configure Gauge Python plugin with debugging enabled
  3. Run any Gauge spec: gauge run --hide-suggestion --simple-console <spec_file>
  4. Observer timeout error

Expected Behavior

The debugger should connect successfully and allow debugging of test execution, as it does in version 1.8.15.

Actual Behavior

Traceback (most recent call last):
  File "<venv>\Lib\site-packages\debugpy\server\api.py", line 235, in listen
    sock, _ = endpoints_listener.accept()
               ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<python>\Lib\socket.py", line 295, in accept
    fd, addr = self._accept()
               ^^^^^^^^^^^^^^
TimeoutError: timed out

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "C:\Users\...\AppData\Roaming\gauge\plugins\python\0.4.11\start.py", line 72, in <module>
    main()
  File "C:\Users\...\AppData\Roaming\gauge\plugins\python\0.4.11\start.py", line 29, in main
    start()
  File "C:\Users\...\AppData\Roaming\gauge\plugins\python\0.4.11\start.py", line 52, in start
    debugpy.listen(('127.0.0.1', int(debug_port)))
  File "<venv>\Lib\site-packages\debugpy\public_api.py", line 47, in wrapper
    return wrapped(*args, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^
  File "<venv>\Lib\site-packages\debugpy\server\api.py", line 133, in debug
    log.reraise_exception("{0}() failed:", func.__name__, level="info")
  File "<venv>\Lib\site-packages\debugpy\server\api.py", line 131, in debug
    return func(address, settrace_kwargs, **kwargs)
           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "<venv>\Lib\site-packages\debugpy\server\api.py", line 249, in listen
    raise RuntimeError("timed out waiting for adapter to connect")
RuntimeError: timed out waiting for adapter to connect

Workaround

Downgrade to debugpy 1.8.15:

pip install debugpy==1.8.15

Additional Context

The issue is in the Gauge Python plugin's start.py (line 52) which calls debugpy.listen(('127.0.0.1', int(debug_port))). Something changed in debugpy 1.8.16 that breaks the adapter connection flow.

The timeout occurs even with extended timeout values configured in Gauge Python properties. This suggests the issue is not just timing but a breaking change in debugpy's API or connection handling.

Suggested Fix

  • Pin debugpy version to <=1.8.15 in plugin requirements, or
  • Update plugin's debugpy integration to work with 1.8.16+, or
  • Investigate if debugpy's listen() API changed and needs different parameters/setup
主要语言
Python
星标
96
派生
38
平均合并
1 小时 18 分钟
30 天内合并 PR
2

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

getgauge/gauge-python 的其他 Issue

查看 getgauge/gauge-python 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。