GitHub hatalarını giderme

Nethür PR kontrolleri, Görevler ve Kaynak Kontrolü'nde hız limitlerini, kimlik doğrulama hatalarını ve diğer GitHub CLI hatalarını teşhis edin.

Nethür GitHub ile makinenizdeki (veya uzak Nethür hostundaki) GitHub CLI (gh) üzerinden konuşur. PR durumu, kontroller, sorunlar veya Görevler yenilenemiyorsa neden neredeyse her zaman GitHub kimlik doğrulaması, izinler veya API hız limitleridir — PR panelinin kendisi bozuk değildir.

Bu sayfa en sık göreceğiniz hataları ve nasıl düzeltileceğini kapsar.

Hızlı triyaj

GördüğünüzMuhtemel nedenİlk denenecek
"GitHub istekleri hız limitliyor" / "rate limit exceeded (core)"Kullanıcınız için GitHub REST (core) kotası tükendiSıfırlanmayı bekleyin; fazladan gh / ajan / Nethür kullanımını durdurun; Ayarlar → Git → GitHub API Bütçesi kontrol edin
"GitHub kimlik doğrulaması kullanılamıyor" / gh auth istemlerigh oturum açmamış, jeton süresi dolmuş veya GITHUB_TOKEN hatalıgh auth status, sonra gh auth login
"GitHub erişime izin vermedi" / HTTP 403 (hız limiti değil)Eksik kapsamlar veya depoya erişim yokrepo (ve gereken kuruluş SSO'su) ile yeniden kimlik doğrulayın; PR'ı tarayıcıda açabildiğinizi doğrulayın
"depo kullanılamıyor" / HTTP 404Yanlış uzak adres, erişimsiz özel depo veya yeniden adlandırılmış depogit remote -v ve tarayıcı erişimini kontrol edin
"GitHub'a ulaşılamıyor" / zaman aşımlarıAğ, proxy, VPN veya GitHub kesintisigithubstatus.com kontrol edin; VPN kapalıyken yeniden deneyin
"GitHub CLI kullanılamıyor"gh, Nethür'ün gördüğü PATH'te yokgh kurun ve Nethür'ü yeniden başlatın

Hız limitleri (en yaygın)

GitHub her kimliği doğrulanmış kullanıcıya paylaşılan saatlik bir bütçe verir. O hesaptaki her araç onu paylaşır: Nethür, terminallerdeki gh, gh çağıran Claude/Codex/Grok ajanları, CI betikleri, tarayıcı uzantıları ve diğer uygulamalar.

Nethür'ün önemsediği kovalar

KovaNeyi kapsarTipik limit (kimlik doğrulanmış)
REST (core)Çoğu PR/sorun/API çağrısı (gh pr view, kontrol meta verisi, birçok REST ucu)Saatte 5.000
GraphQLProje/Görevler ve bazı daha zengin PR sorgularıSaatte 5.000 puan
SearchAramayla yönlendirilen listelerDakikada 30

Bir birincil kova tükendiğinde GitHub API rate limit exceeded gibi bir mesajla HTTP 403 döndürür. Nethür bunu hız limitli olarak sınıflandırır, mümkün olduğunda son bilinen PR durumunu korur ve tek bir limitin hata fırtınasına dönüşmemesi için kısa bir süre daha fazla gh çağrısı başlatmayı durdurur.

Ayarlar "TAMAM" görünürken PR paneli neden engellenebilir

Ayarlar → Git → GitHub API Bütçesi GitHub'ın özel rate_limit ucunu okur. Bu yoklama hız limiti muhasebesinden muaftır ve bazen aynı kullanıcı için gerçek REST çağrıları zaten remaining: 0 döndürürken hâlâ kalan kota bildirir.

Çeliştiklerinde şu sıraya güvenin:

  1. PR / Kontroller panelindeki hata (canlı istek başarısız oldu)
  2. Gerçek bir CLI kontrolü (aşağıda)
  3. Ayarlar bütçe sayıları (yararlı ama yalnızca yoklama)

Ayrıca GitHub API Bütçesini Hesaplar altındaki Claude / Codex / Grok kullanımı ile karıştırmayın — bunlar AI sağlayıcı limitleridir, GitHub'ın REST kotası değil.

Bir terminalden hız limitini doğrulama

bash
# Yoklama (kota tüketmez; gerçeklikten daha sağlıklı görünebilir)
gh api rate_limit --jq '.resources | {core, graphql, search}'

# Gerçek REST çağrısı — PR yenilemesinin bağlı olduğu şey
gh api user -i 2>&1 | head -40

gh api user 403 ve API rate limit exceeded ile X-Ratelimit-Remaining: 0 döndürüyorsa hesap X-Ratelimit-Reset (Unix epoch saniyesi) değerine kadar REST için engellidir.

Kotayı genellikle ne tüketir

  • Aynı anda açık birçok Nethür penceresi veya electron-dev derlemesi (her biri PR'ları / Görevleri yenileyebilir)
  • gh otomatikleştiren ajanlar (PR/sorun atama, kontrol yoklama, toplu GraphQL)
  • PR panellerini yenilerken yoğun Görevler / çok depolu yayılma
  • Aynı GitHub kullanıcı jetonunu kullanan diğer uygulamalar

Ne yapmalı

  1. Hatada veya X-Ratelimit-Reset içinde gösterilen saatlik sıfırlanmayı bekleyin.
  2. Eşzamanlı GitHub istemcilerini azaltın — fazladan Nethür örneklerini kapatın ve toplu gh otomasyonlarını duraklatın.
  3. Limitliyken PR panelinde yenilemeyi vurmayın; Nethür zaten geri çekiliyor.
  4. Betiklerde GraphQL'i gruplamayı tercih edin; kişisel bir hesapta büyük kümelerde tek PR'lık REST döngüsü yapmayın.
  5. Sıfırlandıktan sonra PR yenilemesi hâlâ başarısızsa kimlik doğrulamayı yeniden kontrol edin (sonraki bölüm).

Kimlik doğrulama sorunları

Nethür o hostta gh neyi kullanıyorsa onu miras alır.

Durumu kontrol etme

bash
gh auth status -h github.com
gh api user --jq '{login, id}'

Sağlıklı çıktı: oturum açmış, jeton geçerli, gh api user oturum açma adınızı döndürür.

Yaygın tuzaklar

Kabuk profilinizde GITHUB_TOKEN / GH_TOKEN
Bunlar dışa aktarılmışsa (örneğin ~/.bash_profile veya ~/.zshrc içinde export GITHUB_TOKEN=$(gh auth token)), gh anahtarlık yerine onları tercih eder. Bayat veya yanlış ortam jetonu kafa karıştırıcı kimlik doğrulama ya da hız limiti davranışı üretir. Kaldırın ve yeniden oturum açın:

bash
unset GITHUB_TOKEN GH_TOKEN
gh auth logout -h github.com
gh auth login -h github.com

Süresi dolmuş veya iptal edilmiş jeton
gh auth status jetonu geçersiz gösterebilir. gh auth login (veya gh auth refresh) çalıştırın ve yeni kimlik bilgilerini alması için Nethür'ü yeniden başlatın.

Kuruluş SAML SSO'su
Özel kuruluş depoları jeton için SSO yetkilendirmesi gerektirebilir. GitHub jeton ayarlarından kuruluşun SSO yetkilendirme bağlantısını açın, sonra yeniden deneyin.

Uzak / SSH çalışma alanları
GitHub kimlik doğrulaması host başınadır. Bir makinede oturum açmak uzak makinede gh oturumu açmaz. Hosta SSH ile girip orada gh auth login çalıştırın veya o ortam için Nethür'ün uzak sunucu GitHub bütçe görünümünü kullanın.

İzin ve depo hataları

BelirtiAnlamı
"rate limit" olmadan HTTP 403Jeton kapsamı eksik veya kaynağı görmeye izniniz yok
HTTP 404 / "could not resolve to a Repository"Depo yok, yeniden adlandırılmış veya bu jetona görünmez
"resource not accessible by integration"Uygulama/jeton türü o eylemi yapamaz

Düzeltmeler:

  • gh api user ile aynı kullanıcı olarak oturum açmışken PR/deponun tarayıcıda açıldığını doğrulayın
  • repo (ve bu özellikleri kullanıyorsanız read:org / project) içeren klasik kapsamlarla yeniden kimlik doğrulayın
  • GitHub Enterprise için gh o hostname'e kimlik doğrulamış olmalı (gh auth login --hostname …)

Ağ ve GitHub kesintileri

Zaman aşımları, "could not resolve host" veya "GitHub'a ulaşılamıyor" mesajları bağlantı sorunlarıdır:

  • GitHub Status kontrol edin
  • VPN / kurumsal proxy olmadan deneyin
  • Uzak hostlarda api.github.com adresine giden HTTPS'in çalıştığını doğrulayın

GitHub CLI eksik

Nethür GitHub CLI'nin kullanılamadığını bildiriyorsa:

  1. gh kurun
  2. Normal bir terminalde which gh çalıştığını doğrulayın
  3. Nethür'den tamamen çıkıp yeniden açın (PATH eşleşsin)
  4. Windows'ta Nethür'ün başlattığı ortam için kurun (WSL veya yerel)

GitHub başarısız olduğunda Nethür nasıl davranır

  • Hız limiti / kesinti: PR ve Kontroller panelleri arayüzü silmek yerine son bilinen durumu ve kısa bir banner'ı tercih eder.
  • Sert kimlik doğrulama / izin hataları: Oturum açmayı veya erişimi düzeltmenizi söyleyen net boş durum veya banner metni alırsınız.
  • Devre kesici: Birincil hız limiti 403'ünden sonra Nethür o kova (core, search veya graphql) için kısa süre yeni gh başlatmalarını reddeder; böylece uygulama duyarlı kalır ve daha derin bir çukur kazmaz.

Nethür'de GitHub API Bütçesini kontrol etme

Ayarlar → Git altını açın ve GitHub API Bütçesini bulun:

  • GitHub'ın yoklamasından REST / Search / GraphQL kalan sayıları
  • Bir limiti bekledikten sonra yenileyin
  • Uzak Nethür sunucularında sunucuya ait gh kimliği için uzak gelişmiş bütçe görünümünü kullanın (yerel Ayarlar yalnızca masaüstü istemcisini gösterir)

Hâlâ takıldınız mı?

  1. Nethür'ün kullandığı aynı makine/kullanıcıdan bir terminalde gh pr view veya gh api user ile bir kez yeniden üretin.
  2. Günlükleri toplayın: Yardım → Günlükleri aç.
  3. Sınıflandırılmış hata metni (sırlar değil), gh auth status redakte edilmiş çıktısı ve terminaldeki gh'nin de aynı şekilde başarısız olup olmadığıyla bir sorun bildirin.

İlgili