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

[Bug]: T3 Connect link returns 504 Gateway Timeout from relay, client shows bare "failed"

未关闭 适合新手
#16,810 4 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

维护者通常 1 天内回复

还没有人认领这个 Issue。

评估

难度
2/5
预计耗时
1-3 小时
新手友好度
66/100
Issue 类型
缺陷
描述清晰度
基本清楚
活跃度
活跃
技术栈
electron, typescript
领域
desktop, frontend

调研方向

定位 RelayEnvironmentLinkErrors 枚举,以及向 /v1/client/environment-links 发起 POST 的代码路径(Settings → Connections,T3 Connect 流程)—— 先在仓库中搜索 RelayEnvironmentLinkErrors。将 504 等未处理的 HTTP 状态映射为类型化错误,使 relay 的响应 body 出现在 toast 中,而不是只有一个 "failed"。完成标准是:该端点返回的模拟 504 响应能生成一条包含 relay 原因的消息;运行覆盖 environment-link 客户端的现有测试。注意,上游的 504 本身来自 relay 侧,不在本仓库的控制范围内。

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

描述

bug via-triage
Steps to reproduce
  1. T3 Code desktop 0.0.45 (Electron 44.4.2), macOS.
  2. Settings → Connections → enable T3 Connect for the local environment.
  3. The link challenge and the local link proof succeed; the final link request fails.
Actual behavior

Toast: "Could not update T3 Connect - https://relay.t3.codes/v1/client/environment-links failed", with no reason.

DevTools shows the relay itself answered the POST with 504 Gateway Timeout (application/json, 43 bytes), roughly 9-10 s after the request was sent. 504 is not in RelayEnvironmentLinkErrors, so the client drops the reason.

  • Trace ID (traceparent): 4684d7d140f34f0393d42744d240e207
  • cf-ray: a46cb3018961253d-JNB
  • Time: Wed, 07 Oct 2026 11:52:31 GMT
  • Three earlier attempts the same day, within about 5 minutes starting 10:55 UTC, failed the same way.
Expected behavior

The environment links, or the client shows the relay's reason.

Related: #14070, #14580

主要语言
TypeScript
星标
24.8k
派生
6.4k
平均合并
8 小时 58 分钟
30 天内合并 PR
278

环境准备

在 Codespaces 中打开

在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。

从这里开始

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

pingdotgg/t3code 的其他 Issue

查看 pingdotgg/t3code 的全部 Issue

相似的 Issue

更多 TypeScript Issue

把新 issue 发到你的邮箱

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