Repository navigation
Sorun Giderme
Cavanshirpro edited this page Sep 19, 2026
·
1 revision
English · Türkçe · Languages / Diller
Kapsam: JSON API Forge 0.5.1 · İnceleme: 17 Eylül 2026 · Dil: Türkçe
Sorunu doğru katmanda aramak ilk adımdır: kurulum, config, ağ, kimlik, veri politikası, runtime, client veya desktop packaging. Hata mesajındaki request ID ve component sürümünü kaydedin; sırları paylaşmayın.
| Belirti | Muhtemel neden / işlem |
|---|---|
forge bulunamıyor |
Doğru venv aktif mi? python -m pip show json-api-forge; doğrudan venv executable kullanın |
0 project / readiness 503 |
main boş gelir; açık app kökü, doğru working directory ve manifest |
extra_forbidden |
Yanlış alan adı veya desteklenmeyen sürüm; schema referansını kontrol edin |
Env URL None/boş |
$env: sözdizimi, değişkenin bulunduğu süreç ve mevcut boş değer |
init var olan dosyayı reddediyor |
Beklenen koruma; --force rotasyonunu anlamadan kullanmayın |
| Duplicate route/slug | İki fragment'e aynı resource eklenmiş veya prefix'ler çakışıyor |
| Yeni JSON etkilenmedi | Watcher kapalı, geçersiz aday, debounce veya eski bağlantılar drain oluyor |
| Hook değişmedi | Python restart gerekir; JSON watcher yeterli değil |
| DB schema hatası | Migration ve schema create/validate modu |
| Cache eski veri | TTL/stale/invalidation; DB'ye Forge dışı yazma |
| Belirti | İnceleme |
|---|---|
| Bootstrap 401 | İlk başarılı kalıcı key üretiminde tüketildi mi? |
| Key geçerli ama 403 | İzin, tenant/owner, doğru proje, expiry ve scope |
| Proxy arkasında HTTPS hatası | Doğrudan peer gerçekten trusted CIDR içinde mi? |
| Yanlış filtrede çok sonuç | v0.5.1 SQL bilinmeyen/izin dışı filtreyi atlar |
| Cursor ile 400 | Offset/sort gönderilmiş mi, doğru pagination mode mu? |
| POST retry çift iş | Server operation gerçekten idempotent mi? |
| RPC 409 | Değişen fingerprint, rowcount guard veya eşzamanlı işlem |
| Yükte 429/503 | Rate ve concurrency farklı sınırlar; doğru IP/kapasiteyi inceleyin |
| Belirti | İnceleme |
|---|---|
| Yanlış paket/import | Paket json-api-forge-client, import json_api_forge
|
| HTTP URL reddi | Yalnız loopback + açık opt-in; uzakta HTTPS |
İki kez /api/...
|
Base URL'ye helper'ın eklediği prefix'i eklemişsiniz |
| GET operation POST oluyor |
call_operation POST helper'ıdır; request kullanın |
Async iter_items yok |
v0.5.1'de yalnız sync; bounded async döngü yazın |
ResponseTooLarge |
Gerçek response hacmi; pagination veya bilinçli limit |
| Compressed response reddi | Proxy Accept-Encoding: identity'yi gözetmiyor |
| Wheel unsupported | İncelenen release'teki any_lib tag'i; source commit/sdist yolu |
| DDM import | Opsiyonel extra/uyumlu YoungLion kurulumu |
| Belirti | İnceleme |
|---|---|
| Control plane 404 |
EDITOR_API_ENABLED, doğru runtime ve deployment base |
| App key ile login olmuyor | Ayrı Editor account/session gerekir |
| Local validate geçiyor, server reddediyor | Local yapısal kontrol ile merged semantik validation farklı |
| Save 409 | Eski SHA; yeni server sürümünü okuyup değişiklikleri uzlaştırın |
| Graph kaydı çalışmıyor | Graph policy/permission; compile preview ayrı |
| Branch/Transform node derlenmiyor | Bu sürümde design-only |
| Plugin import edildi ama yok | Import enable etmez; Manage plugins incelemesi |
| Plugin load/Qt error | Platform, ABI, mimari, library hash ve bağımlılıklar |
| Calls yok | WSGI sınırı, WSS proxy, TURN ve server policy |
| Portable app Qt platform hatası | Stage/deployment eksik veya binary tek başına taşınmış |
Component, tam sürüm/commit, OS/CPU, Python veya Qt kit, çalıştırılan komut, beklenen/gerçek sonuç ve küçük sırdan arındırılmış config örneği verin. Request ID ve tam traceback'in hassas olmayan bölümleri yardımcı olur. Güvenlik açığını normal public issue'ya yazmadan önce SECURITY.md kanalını kullanın.
Bu sayfa aşağıdaki sabit commitlerdeki davranışı açıklar. Yeni bir sürümde aynı davranışın sürdüğünü varsaymayın.
main/SUPPORT.mdmain/SECURITY.mdpython-library/json_api_forge/client.pyEditor/QT-CREATOR-BUILD-GUIDE.md