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üz | Muhtemel neden | İlk denenecek |
|---|---|---|
| "GitHub istekleri hız limitliyor" / "rate limit exceeded (core)" | Kullanıcınız için GitHub REST (core) kotası tükendi | Sı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 istemleri | gh 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 yok | repo (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 404 | Yanlış uzak adres, erişimsiz özel depo veya yeniden adlandırılmış depo | git remote -v ve tarayıcı erişimini kontrol edin |
| "GitHub'a ulaşılamıyor" / zaman aşımları | Ağ, proxy, VPN veya GitHub kesintisi | githubstatus.com kontrol edin; VPN kapalıyken yeniden deneyin |
| "GitHub CLI kullanılamıyor" | gh, Nethür'ün gördüğü PATH'te yok | gh 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
| Kova | Neyi kapsar | Tipik 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 |
| GraphQL | Proje/Görevler ve bazı daha zengin PR sorguları | Saatte 5.000 puan |
| Search | Aramayla yönlendirilen listeler | Dakikada 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:
- PR / Kontroller panelindeki hata (canlı istek başarısız oldu)
- Gerçek bir CLI kontrolü (aşağıda)
- 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
# 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 -40gh 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)
ghotomatikleş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ı
- Hatada veya
X-Ratelimit-Resetiçinde gösterilen saatlik sıfırlanmayı bekleyin. - Eşzamanlı GitHub istemcilerini azaltın — fazladan Nethür örneklerini kapatın ve toplu
ghotomasyonlarını duraklatın. - Limitliyken PR panelinde yenilemeyi vurmayın; Nethür zaten geri çekiliyor.
- 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.
- 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
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:
unset GITHUB_TOKEN GH_TOKEN
gh auth logout -h github.com
gh auth login -h github.comSü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ı
| Belirti | Anlamı |
|---|---|
| "rate limit" olmadan HTTP 403 | Jeton 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 userile aynı kullanıcı olarak oturum açmışken PR/deponun tarayıcıda açıldığını doğrulayınrepo(ve bu özellikleri kullanıyorsanızread:org/project) içeren klasik kapsamlarla yeniden kimlik doğrulayın- GitHub Enterprise için
gho 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.comadresine giden HTTPS'in çalıştığını doğrulayın
GitHub CLI eksik
Nethür GitHub CLI'nin kullanılamadığını bildiriyorsa:
ghkurun- Normal bir terminalde
which ghçalıştığını doğrulayın - Nethür'den tamamen çıkıp yeniden açın (PATH eşleşsin)
- 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,searchveyagraphql) için kısa süre yenighbaş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
ghkimliğ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ı?
- Nethür'ün kullandığı aynı makine/kullanıcıdan bir terminalde
gh pr viewveyagh api userile bir kez yeniden üretin. - Günlükleri toplayın: Yardım → Günlükleri aç.
- Sınıflandırılmış hata metni (sırlar değil),
gh auth statusredakte edilmiş çıktısı ve terminaldekigh'nin de aynı şekilde başarısız olup olmadığıyla bir sorun bildirin.
İlgili
- Barındırılan incelemeler, sorunlar ve Actions — GitHub'a bağlı PR ve Kontroller özellikleri
- Ayarlar referansı — Entegrasyonlar ve Git panelleri
- Kullanım ve hız limiti takibi — AI sağlayıcı limitleri (Claude/Codex), GitHub API değil
- Sorun giderme ve SSS — genel Nethür sorunları