Saltar al contenido principal

🔧 Solución Error de Corrupción de Turbopack

❌ Error​

Failed to restore task data (corrupted database or bug)
Unable to open static sorted file 00000002.sst
No such file or directory (os error 2)

Este error indica que la base de datos interna de Turbopack está corrupta.

✅ Solución Rápida​

Opción 1: Limpiar Cache Manualmente​

  1. Detén el servidor (Ctrl+C si está corriendo)

  2. Elimina los directorios de cache:

    rm -rf .next
    rm -rf .turbo
    rm -rf node_modules/.cache

  3. Si no se puede eliminar, fuerza la eliminación:

    # En macOS/Linux
    sudo rm -rf .next .turbo node_modules/.cache

    # O cierra todas las terminales y procesos de Next.js, luego:
    rm -rf .next .turbo node_modules/.cache

  4. Reinicia el servidor:

    pnpm dev

Opción 2: Usar sin Turbopack (Temporal)​

Si el error persiste, usa Next.js sin Turbopack:

pnpm dev:webpack

Opción 3: Reiniciar el Sistema​

Si nada funciona:

  1. Cierra todas las terminales
  2. Cierra cualquier proceso de Node.js/Next.js
  3. Reinicia tu computadora (opcional pero a veces necesario)
  4. Luego ejecuta los pasos de la Opción 1

🔍 Causa​

Este error ocurre cuando:

  • Turbopack se interrumpe abruptamente
  • Hay problemas de permisos en los archivos
  • El sistema de archivos tiene problemas
  • Hay múltiples instancias de Next.js corriendo

📝 Prevención​

  • Siempre detén el servidor con Ctrl+C antes de cerrar la terminal
  • No ejecutes múltiples instancias de pnpm dev al mismo tiempo
  • Si el servidor se cuelga, mata el proceso antes de reiniciar

⚠️ Nota​

Este es un problema conocido de Turbopack en desarrollo. Si persiste, considera usar pnpm dev:webpack temporalmente hasta que se resuelva en futuras versiones de Next.js.