Si estás desarrollando en React Native o Android en macOS y de repente el build falla con un error largo de Gradle, es muy probable que el problema no sea tu código.
Uno de los mensajes más habituales es este:
org.gradle.api.UncheckedIOException: java.io.IOException: No space left on device
Aunque pueda parecer un error interno de Gradle, la causa real es mucho más simple: tu disco está lleno.
En este tutorial te explico:
- Qué significa realmente este error
- Cómo detectarlo correctamente en macOS
- Qué puedes borrar de forma segura
- Cómo evitar que vuelva a ocurrir
1. El síntoma: Gradle falla sin motivo aparente
El error suele aparecer durante un build de Android y apunta a rutas como:
android/.gradle/8.x/fileHashes/fileHashes.bin
o a librerías nativas del tipo:
librnscreens.so
Esto suele llevar a pensar que:
- hay un problema con Gradle
- hay una dependencia rota
- el proyecto está mal configurado
Nada más lejos de la realidad.
2. La causa real: la partición de datos está llena
En macOS, especialmente con APFS, puede pasar que el sistema “parezca” tener espacio, pero la partición importante esté al límite.
Compruébalo con:
df -h
Si ves algo como esto:
/System/Volumes/Data 100%
El diagnóstico es claro:
- macOS no puede escribir
- Gradle no puede crear caché
- el build falla inevitablemente
3. El principal culpable: Xcode y los simuladores de iOS
Xcode acumula con el tiempo:
- simuladores antiguos
- runtimes de iOS completos
- imágenes Cryptex
Cada versión de iOS puede ocupar entre 6 y 10 GB, y no se eliminan automáticamente.
Las rutas típicas son:
~/Library/Developer/CoreSimulator ~/Library/Developer/Xcode/DerivedData
Limpieza segura (recomendado)
Eliminar simuladores no usados
Este comando elimina simuladores obsoletos de forma segura:
xcrun simctl delete unavailable
Para una limpieza completa (recomendado si no usas Xcode a diario):
rm -rf ~/Library/Developer/CoreSimulator/*
Borrar DerivedData de Xcode
Totalmente seguro, Xcode lo regenera cuando lo necesita:
rm -rf ~/Library/Developer/Xcode/DerivedData
Limpieza del entorno Android y React Native
Después de liberar espacio, conviene limpiar caches de build:
rm -rf ~/.gradle/caches rm -rf android/.gradle rm -rf node_modules
Luego reinstala y limpia el proyecto:
npm install cd android ./gradlew clean
Si usas Docker (muy habitual)
Docker suele ser otro gran consumidor silencioso de disco.
Utiliza:
docker system df
Y limpia todo lo que no se use:
docker system prune -a
Esto puede liberar decenas de GB.
Cuánto espacio necesitas realmente
Para trabajar con Android y React Native en macOS:
- mínimo funcional: 15 GB libres
- recomendado: 30 GB o más
Con menos espacio, los errores de build volverán a aparecer.
Conclusión
Si ves un error de Gradle relacionado con caché o escritura en disco:
- No pierdas tiempo tocando código
- No reinstales dependencias a ciegas
- Comprueba primero el espacio en disco
En la mayoría de casos, el problema no es Gradle, es macOS acumulando basura de desarrollo.
Ingeniero en Informática, Investigador, me encanta crear cosas o arreglarlas y darles una nueva vida. Escritor y poeta. Más de 20 APPs publicadas y un libro en Amazon.