elysia-nginx-500-debug

What problem does it solve?

This Skill addresses random HTTP 500 errors that occur when Elysia.js (Bun) backends are proxied through nginx, where direct calls to the backend return 200 responses consistently but nginx-proxied requests fail 40-60% of the time with no corresponding nginx error log entries.

Core Features & Use Cases

• Structured Debugging Workflow: Step-by-step guidance to isolate the root cause of the nginx 500 errors, including checks for backend health, nginx error logs, and masked nginx services.
• Documented Failed Fixes: Pre-compiled list of common nginx configuration tweaks that do not resolve the issue, saving hours of redundant troubleshooting.
• Proven Working Solution: Provides a compatible Node.js http module replacement backend code that eliminates the Elysia.js and nginx HTTP/1.1 keepalive compatibility issue causing the failures. Use Case: For development and operations teams running Elysia.js APIs behind nginx, use this Skill to quickly diagnose and resolve intermittent 500 errors without extensive trial-and-error of nginx configurations.

Quick Start

Use the elysia-nginx-500-debug skill to diagnose and fix intermittent HTTP 500 errors affecting your Elysia.js backend proxied through nginx.