Database Not Ready

database-not-ready · 503

استيقظت القاعدة لكنها لم تقبل اتصالا في الوقت المحدد، فلم تفتح الـ API أي tunnel بدل أن تعطيك port لا يرد على شيء.

كل الصفحات

الـ timeoutSeconds هو المدة التي انتظرتها الـ API، 30 ثانية عادة. والإيقاظ نفسه نجح، فالقاعدة مستيقظة للمحاولة التالية.

إضافة إلى الحقول التي في كل خطأ، يضيف هذا النوع service، environment و timeoutSeconds.

الأسباب الشائعة

  • استغرق PostgreSQL وقتا أطول من المعتاد ليقبل الاتصالات بعد أن استيقظ.
  • لم يرد Redis على ping في الوقت المحدد.

كيف تصلح الطلب

  • شغل الأمر نفسه مرة أخرى: هذه من الحالات التي تكون فيها إعادة المحاولة دون تغيير هي الصواب.
  • وإذا استمر الفشل، فأخبر المستخدم: قد تكون القاعدة غير قادرة على العمل.

مثال على الرد

json
{
  "type": "database-not-ready",
  "title": "Database Not Ready",
  "detail": "orders-db woke but did not accept a connection within 30 s in staging. Try again.",
  "service": "orders-db",
  "environment": "staging",
  "timeoutSeconds": 30,
  "requestId": "req-1785231000000-4f7b2c9ae",
  "timestamp": "2026-07-28T09:30:00.000Z",
  "path": "/v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels",
  "method": "POST",
  "instance": "POST /v1/services/0199e0a3-6f21-7c4a-9d18-2b7c5f3ad401/tunnels",
  "status": 503,
  "docs": "https://ghaym.me/docs/errors/database-not-ready"
}