Fastify
Hatalar
İçindekiler
HatalarNode.js İçinde Hata YönetimiYakalanmamış HatalarSözleşmelerde Hataları Yakalama
Fastify İçindeki HatalarGiriş Verilerindeki HatalarFastify İçinde Yakalanmamış Hataları Yakalama
Fastify Yaşam Döngüsü Kancalarında ve Özel Hata YöneticiFastify Hata KodlarıFST_ERR_NOT_FOUNDFST_ERR_OPTIONS_NOT_OBJFST_ERR_QSP_NOT_FNFST_ERR_SCHEMA_CONTROLLER_BUCKET_OPT_NOT_FNFST_ERR_SCHEMA_ERROR_FORMATTER_NOT_FNFST_ERR_AJV_CUSTOM_OPTIONS_OPT_NOT_OBJFST_ERR_AJV_CUSTOM_OPTIONS_OPT_NOT_ARRFST_ERR_CTP_ALREADY_PRESENTFST_ERR_CTP_INVALID_TYPEFST_ERR_CTP_EMPTY_TYPEFST_ERR_CTP_INVALID_HANDLERFST_ERR_CTP_INVALID_PARSE_TYPEFST_ERR_CTP_BODY_TOO_LARGEFST_ERR_CTP_INVALID_MEDIA_TYPEFST_ERR_CTP_INVALID_CONTENT_LENGTHFST_ERR_CTP_EMPTY_JSON_BODYFST_ERR_CTP_INSTANCE_ALREADY_STARTEDFST_ERR_INSTANCE_ALREADY_LISTENINGFST_ERR_DEC_ALREADY_PRESENTFST_ERR_DEC_DEPENDENCY_INVALID_TYPEFST_ERR_DEC_MISSING_DEPENDENCYFST_ERR_DEC_AFTER_STARTFST_ERR_DEC_REFERENCE_TYPEFST_ERR_HOOK_INVALID_TYPEFST_ERR_HOOK_INVALID_HANDLERFST_ERR_HOOK_INVALID_ASYNC_HANDLERFST_ERR_HOOK_NOT_SUPPORTEDFST_ERR_MISSING_MIDDLEWAREFST_ERR_HOOK_TIMEOUTFST_ERR_LOG_INVALID_DESTINATIONFST_ERR_LOG_INVALID_LOGGERFST_ERR_LOG_INVALID_LOGGER_INSTANCEFST_ERR_LOG_INVALID_LOGGER_CONFIGFST_ERR_LOG_LOGGER_AND_LOGGER_INSTANCE_PROVIDEDFST_ERR_REP_INVALID_PAYLOAD_TYPEFST_ERR_REP_RESPONSE_BODY_CONSUMEDFST_ERR_REP_ALREADY_SENTFST_ERR_REP_SENT_VALUEFST_ERR_SEND_INSIDE_ONERRFST_ERR_SEND_UNDEFINED_ERRFST_ERR_BAD_STATUS_CODEFST_ERR_BAD_TRAILER_NAMEFST_ERR_BAD_TRAILER_VALUEFST_ERR_FAILED_ERROR_SERIALIZATIONFST_ERR_MISSING_SERIALIZATION_FNFST_ERR_MISSING_CONTENTTYPE_SERIALIZATION_FNFST_ERR_REQ_INVALID_VALIDATION_INVOCATIONFST_ERR_SCH_MISSING_IDFST_ERR_SCH_ALREADY_PRESENTFST_ERR_SCH_CONTENT_MISSING_SCHEMAFST_ERR_SCH_DUPLICATEFST_ERR_SCH_VALIDATION_BUILDFST_ERR_SCH_SERIALIZATION_BUILDFST_ERR_SCH_RESPONSE_SCHEMA_NOT_NESTED_2XXFST_ERR_HTTP2_INVALID_VERSIONFST_ERR_INIT_OPTS_INVALIDFST_ERR_FORCE_CLOSE_CONNECTIONS_IDLE_NOT_AVAILABLEFST_ERR_DUPLICATED_ROUTEFST_ERR_BAD_URLFST_ERR_ASYNC_CONSTRAINTFST_ERR_INVALID_URLFST_ERR_ROUTE_OPTIONS_NOT_OBJFST_ERR_ROUTE_DUPLICATED_HANDLERFST_ERR_ROUTE_HANDLER_NOT_FNFST_ERR_ROUTE_MISSING_HANDLERFST_ERR_ROUTE_METHOD_INVALIDFST_ERR_ROUTE_METHOD_NOT_SUPPORTEDFST_ERR_ROUTE_BODY_VALIDATION_SCHEMA_NOT_SUPPORTEDFST_ERR_ROUTE_BODY_LIMIT_OPTION_NOT_INTFST_ERR_ROUTE_REWRITE_NOT_STRFST_ERR_REOPENED_CLOSE_SERVERFST_ERR_REOPENED_SERVERFST_ERR_PLUGIN_VERSION_MISMATCHFST_ERR_PLUGIN_CALLBACK_NOT_FNFST_ERR_PLUGIN_NOT_VALIDFST_ERR_ROOT_PLG_BOOTEDFST_ERR_PARENT_PLUGIN_BOOTEDFST_ERR_PLUGIN_TIMEOUTFST_ERR_PLUGIN_NOT_PRESENT_IN_INSTANCEFST_ERR_PLUGIN_INVALID_ASYNC_HANDLERFST_ERR_VALIDATIONFST_ERR_LISTEN_OPTIONS_INVALIDFST_ERR_ERROR_HANDLER_NOT_FN
Node.js İçinde Hata Yönetimi
Yakalanmamış Hatalar
Node.js’de yakalanmamış hatalar, bellek sızıntılarına, dosya tanımlayıcı sızıntılarına ve diğer büyük üretim sorunlarına neden olabilir. Domain'ler bunu çözmek için başarısız bir girişimdi.
Tüm yakalanmamış hataları mantıklı bir şekilde işlemek mümkün olmadığından, onlarla başa çıkmanın en iyi yolu çökme.
Sözleşmelerde Hataları Yakalama
Eğer sözleşmeleri kullanıyorsanız, senkron olarak .catch() yöneticisini eklemelisiniz.
İçindeki Hatalar
Fastify, her şey ya da hiçbiri yaklaşımını takip eder ve mümkün olduğunca hafif ve optimal olmaya çalışır. Geliştirici, hataların düzgün bir şekilde işlenmesini sağlamakla sorumludur.
Giriş Verilerindeki Hatalar
Most errors are a result of unexpected input data, so we recommend validating your input data against a JSON schema.
İçinde Yakalanmamış Hataları Yakalama
Fastify, performansı engellemeden yakalanmamış hataları mümkün olduğunca yakalamaya çalışır. Bu şunları içerir:
- senkron rotalar, örneğin
app.get('/', () => { throw new Error('kaboom') }) asyncrotalar, örneğinapp.get('/', async () => { throw new Error('kaboom') })
Her iki durumda da hata güvenli bir şekilde yakalanır ve Fastify’ın varsayılan hata yöneticisine yönlendirilir, bu da genel bir 500 Internal Server Error yanıtı gönderir.
Bu davranışı özelleştirmek için
setErrorHandler kullanmalısınız.
Yaşam Döngüsü Kancalarında ve Özel Hata Yönetici
Hooks belgelerinde belirtildiği gibi:
Eğer kanca yürütmesi sırasında bir hata alırsanız, sadece
done()'a iletin ve Fastify otomatik olarak isteği kapatacak ve kullanıcıya uygun hata kodunu gönderecektir.
Özel bir hata yöneticisi, setErrorHandler üzerinden tanımlandığında, bu yönetici done() geri çağrısına geçen hatayı (veya diğer desteklenen otomatik hata yönetimi mekanizmaları aracılığıyla) alır. setErrorHandler birden çok kez kullanılarak birden çok yönetici tanımlanırsa, hata, hata kapsama bağlamında tanımlanan en önde gelen yöneticisine yönlendirilir. Hata yöneticileri tamamen kapsüllenmiştir, bu nedenle bir eklenti içinde setErrorHandler çağrısı, hata yöneticisini yalnızca o eklentinin bağlamı ile sınırlayacaktır.
Kök hata yöneticisi, Fastify'ın genel hata yöneticisidir. Bu hata yöneticisi, mevcutsa Error nesnesindeki başlıkları ve durum kodunu kullanacaktır. Özel bir hata yöneticisi sağlanırsa, başlıklar ve durum kodu otomatik olarak ayarlanmıyor.
Özel hata yöneticiğinizde dikkate almanız gereken bazı şeyler:
reply.send(data)çağrısı yapabilirsiniz, bu danormal rota yöneticilerindenasıl davranıyorsa öyle davranacaktır.- nesneler serileştirilir, tanımlı bir
preSerializationyaşam döngüsü kancası varsa bu tetiklenir - dizeler, tamponlar ve akışlar istemciye gönderilir, uygun başlıklarla (serileştirme yok)
- nesneler serileştirilir, tanımlı bir
Özel hata yöneticinizde yeni bir hata fırlatabilirsiniz - hatalar (yeni hata veya alınan hata parametresi tekrar fırlatılır) - üst
errorHandler'ı çağıracaktır.onErrorkancası yalnızca ilk fırlatılan hata için bir kez tetiklenecektir.- bir yaşam döngüsü kancasından hata iki kez tetiklenmeyecektir - Fastify, hata çağrısını içsel olarak izleyerek yanıtlama aşamalarında (rota yöneticisinden sonraki) meydana gelen sonsuz döngülerden kaçınır.
setErrorHandler üzerinden Fastify'ın özel hata yönetimini kullanırken, özel ve varsayılan hata yöneticileri arasındaki hata yayılımının nasıl olduğunu bilmelisiniz.
Eğer bir eklentinin hata yöneticisi bir hatayı tekrar fırlatırsa ve hata Error örneği değilse (aşağıdaki örnekte /bad rotasında görüldüğü gibi), bu hata üst bağlam hata yöneticisine yayılmayacaktır. Bunun yerine varsayılan hata yöneticisi tarafından yakalanacaktır.
Tutarlı bir hata yönetimi sağlamak için, Error örnekleri fırlatmanız önerilir. Örneğin, aşağıdaki örnekte /bad rotasında throw 'foo' yerine throw new Error('foo') kullanmak, hataların özel hata yönetim zincirinde gerektiği gibi yayılmasını sağlar. Bu uygulama, Fastify'da özel hata yönetimi ile çalışırken potansiyel tehlikelerden kaçınmanıza yardımcı olur.
Örneğin:
const Fastify = require('fastify')
// Çerçeveyi başlat
const fastify = Fastify({
logger: true
})
// Üst hata yöneticisini ekle
fastify.setErrorHandler((error, request, reply) => {
reply.status(500).send({ ok: false })
})
fastify.register((app, options, next) => {
// Çocuk hata yöneticisini ekle
fastify.setErrorHandler((error, request, reply) => {
throw error
})
fastify.get('/bad', async () => {
// Hata tipinde bir değer fırlatır, 'bar'
throw 'foo'
})
fastify.get('/good', async () => {
// Bir Error örneği fırlatır, 'bar'
throw new Error('bar')
})
next()
})
// Sunucuyu çalıştır
fastify.listen({ port: 3000 }, function (err, address) {
if (err) {
fastify.log.error(err)
process.exit(1)
}
// Sunucu ${address} adresinde dinliyor
})