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

LocalWebserver stuck if some other application is running on windows

未关闭
  • 哪里不对？
#378 0 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
4/5
预计耗时
3-5 天
新手友好度
45/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
停滞
技术栈
python
领域
authentication, backend

调研方向

从 gauth.LocalWebserverAuth() 入口点开始，跟踪它如何绑定端口 8080 并构造 OAuth 重定向。验证 8080 被占用时的行为，然后确认备用端口会反映在重定向中，并且命令会在授权后完成。

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

描述

Hi,

When something is already running on port 8080, calling:

gauth.LocalWebserverAuth()
successfully opens the browser for OAuth, but after granting access, the redirect to http://localhost:8080/?code=... fails with ERR_CONNECTION_REFUSED.
The command line then just waits indefinitely for the code, because the local server never started on that port.

This happens because LocalWebserverAuth tries to bind to 8080 without checking if it’s free.

Proposed fix:
Check if the port is available before binding, and try alternatives in a small range (e.g., 8080–8085) before raising an error. Example using portpicker:


import portpicker

candidate_ports = [8080] + list(range(8081, 8086))
port_number = None
for p in candidate_ports:
    if portpicker.is_port_free(p):
        port_number = p
        break

if port_number is None:
    raise RuntimeError("No free port in range 8080–8085")

print(f"Using port {port_number}")

If a non-default port is selected, it would also need to be reflected in the OAuth URL so the redirect URI matches.
Users can pre-register multiple redirect URIs in Google Cloud Console to cover the fallback ports.

主要语言
Python
星标
668
派生
75
30 天内没有已合并 PR

环境准备

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

从这里开始

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

iterative/PyDrive2 的其他 Issue

查看 iterative/PyDrive2 的全部 Issue

相似的 Issue

更多 Python Issue

把新 issue 发到你的邮箱

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