A Fastify plugin to disable response validation
npm install fastify-no-response-validation
Disable response validation in Fastify.
By default, Fastify doesn't validate responses unless you're using the @fastify/response-validation plugin, which only supports AJV (Fastify's default validator). However, when working with Zod schemas, especially through fastify-zod-openapi or fastify-type-provider-zod, response validation is automatically enabled.
This plugin disables response validation in Fastify. After applying this plugin:
1. Responses that don't match the defined schema won't trigger a 500 error
2. API performance improves as response validation overhead is removed
3. Schema documentation is preserved for API documentation purposes
When using this plugin, you don't need to include fastify.setSerializerCompiler(serializerCompiler) in your setup. The plugin takes care of serialization internally.
``bash`
npm install fastify-no-response-validation
`typescript
import Fastify from 'fastify';
import fastifyNoResponseValidation from 'fastify-no-response-validation';
import { validatorCompiler, type FastifyZodOpenApiTypeProvider } from 'fastify-zod-openapi';
import { z } from 'zod';
const fastify = Fastify().withTypeProvider
// Set up Zod validation
fastify.setValidatorCompiler(validatorCompiler);
// Register the plugin to disable response validation
fastify.register(fastifyNoResponseValidation);
// Define a route with a schema
fastify.get('/user', {
schema: {
response: {
200: z.object({
id: z.number(),
name: z.string(),
}),
},
},
}, (request, reply) => {
// This response doesn't match the schema, but it will still be sent
return { name: 'John', age: 30 } as any;
});
fastify.listen({ port: 3000 }, (err) => {
if (err) throw err;
console.log('Server is running on http://localhost:3000');
console.log('Try: http://localhost:3000/user');
});
``
This plugin is compatible with Fastify v4.x and v5.x.
Contributions, issues, and feature requests are welcome!
This project is licensed under the MIT License.