npm run dev falla al ejecutar un proyecto Vite React creado con scaffolding de Vite usando Node 22.18.0. El error más relevante era SyntaxError: The requested module node:fs/promises does not provide an export named constants, que aparece cuando un módulo intenta importar constants desde node:fs/promises.
Qué sucede. El espacio de nombres node:fs/promises no exporta la propiedad constants. Esa constante pertenece al módulo principal node:fs, por lo que intentar importar constants desde node:fs/promises produce el error indicado. En algunos casos este problema surge por incompatibilidades entre versiones de Node y versiones de dependencias como Vite o paquetes que asumen una estructura de exports distinta.
Soluciones prácticas. 1) Cambiar la importación para obtener constants desde node:fs en lugar de node:fs/promises. Por ejemplo importar fsp desde node:fs/promises y importar constants desde node:fs o importar todo fs desde node:fs y usar fs.promises y fs.constants. 2) Actualizar Vite y las dependencias a versiones compatibles con la versión de Node instalada. Ejecutar npm install vite@latest o actualizar el resto de paquetes relevantes. 3) Si la librería usada no está actualizada, usar una versión LTS de Node más compatible, por ejemplo Node 18, mediante nvm use 18 o instalando la versión adecuada. 4) Limpiar instalación y reinstalar dependencias: eliminar node_modules y el archivo de bloqueo y ejecutar npm install de nuevo. Estas acciones suelen resolver errores relacionados con exports incompatibles.
Ejemplos de cambios de importación que evitan el error. Importar constants desde node:fs en lugar de node:fs/promises. Alternativamente importar todo el módulo fs con import * as fs from node:fs y luego usar fs.promises y fs.constants según sea necesario. Si no se puede editar la dependencia afectada, actualizar o cambiar la versión de Node suele ser la vía rápida.
Pasos recomendados en orden. 1 Comprobar la versión de Node con node -v. 2 Probar con Node 18 si se complica con Node 22. 3 Actualizar Vite y dependencias con npm update o instalar versiones específicas compatibles. 4 Borrar node_modules y el lockfile y reinstalar dependencias. 5 Revisar el repositorio de la dependencia que falla para ver si hay parches o issues relacionados.
Si necesitas ayuda para aplicar la solución o para ajustar el entorno de desarrollo, en Q2BSTUDIO somos especialistas en desarrollo de software a medida y aplicaciones a medida. Podemos acompañarte en la migración de entornos Node, actualización de dependencias y adaptación de proyectos React y Vite para entornos productivos. Somos expertos en inteligencia artificial, ia para empresas, agentes IA y soluciones seguras con enfoque en ciberseguridad.
Además ofrecemos servicios cloud aws y azure, servicios inteligencia de negocio y power bi para mejorar la visualización y análisis de datos. Si tu proyecto requiere software a medida, integración de inteligencia artificial o auditoría de seguridad, Q2BSTUDIO puede diseñar una solución completa, desde la arquitectura cloud hasta la entrega y mantenimiento.
Contacto y siguiente paso. Si prefieres que revisemos el error en tu repositorio podemos auditar las dependencias, proponer la corrección de imports o gestionar la versión de Node y la configuración de Vite para que npm run dev funcione correctamente. En Q2BSTUDIO combinamos experiencia en desarrollo de aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, agentes IA y power bi para ofrecer soluciones adaptadas a tu negocio.
Resumen rápido. El error se debe a que node:fs/promises no exporta constants. Mover la importación de constants a node:fs, actualizar dependencias o usar una versión de Node compatible suelen solucionar npm run dev fails en proyectos Vite React.