Un mensaje de Nextcloud WebGUI como «Excepción: Error de base de datos » inmediatamente después de una actualización suele indicar que la aplicación web se carga lo suficiente como para acceder a la base de datos, pero que falla una consulta, migración, expectativa de esquema, conexión u operación específica de la aplicación. No comience eliminando tablas, reinstalando Nextcloud ni restaurando un directorio de código antiguo sobre el nuevo. La secuencia más segura consiste en identificar la consulta SQL o la migración que falla, completar la ruta de actualización compatible, reparar solo lo que Nextcloud pueda reparar y verificar el servicio y el esquema de la base de datos antes de volver a acceder a ella.
Esta referencia sigue la documentación de administración actual de Nextcloud 35 disponible en octubre de 2026. Los comandos a continuación asumen una instalación común de estilo Debian/Ubuntu /var/www/nextcloudcon el usuario del servidor web www-data. Ajuste la ruta, el binario PHP, el comando del contenedor o el usuario HTTP según su implementación.
| Lo que ves | Posible rama | Primero verifica |
|---|---|---|
| El error apareció inmediatamente después de reemplazar los archivos de Nextcloud. | Las migraciones de bases de datos/aplicaciones no se completaron. | occ statusyocc upgrade |
| El registro indica que no existe una tabla o columna. | Migración incompleta, incompatibilidad de aplicaciones o desviación del esquema. | occ upgrade, luego inspección del esquema |
| El registro indica que la conexión fue rechazada, que el archivo no existe o que el servidor se ha desconectado. | Problema con el servicio de base de datos, el socket, el host, las credenciales o la versión. | Servicio de base de datos yconfig.php |
| El error hace referencia a un espacio de nombres de una aplicación de terceros o a sus tablas. | La aplicación es incompatible o su migración falló. | Deshabilita esa aplicación desde la línea de comandos y vuelve a intentar la actualización. |
| Los informes de resumen administrativo muestran índices/columnas/claves primarias faltantes. | Queda trabajo opcional de esquema posterior a la actualización. | Ejecuta los db:add-missing-*comandos documentados. |
Si aún conserva la copia de seguridad anterior a la actualización, manténgala intacta. Nextcloud recomienda explícitamente realizar una copia de seguridad antes de cada actualización, y su herramienta de copia de seguridad integrada cubre el código fuente, pero no la base de datos ni el directorio de datos . Si no dispone de una copia de seguridad reciente de la base de datos, cree una con la herramienta de copia de seguridad habitual de su plataforma de base de datos antes de intentar realizar cambios o restauraciones manuales en SQL.
Evite degradar la versión como solución rápida. Nextcloud indica que la degradación no es compatible y puede dañar los datos. Si fuera necesario revertir la versión, el modelo de recuperación compatible consiste en una instalación nueva de la versión anterior, seguida de la restauración de una copia de seguridad coincidente, en lugar de copiar archivos de programas antiguos sobre una base de datos que ya ha comenzado a migrarse. Consulte la documentación del actualizador integrado de Nextcloud .
Con el registro de archivos, el archivo de registro predeterminado se encuentra nextcloud.logdentro del directorio de datos configurado. La guía de solución de problemas de Nextcloud recomienda revisar ese archivo de registro y, cuando corresponda, los registros del servidor web y de PHP. Si la página de error muestra un ID de solicitud, busque ese ID para identificar la transacción correspondiente.
sudo -u www-data tail -n 100 /var/www/nextcloud/data/nextcloud.log
No reduzca el registro a la frase "Error de base de datos". Capture el código SQLSTATE, la clase de excepción, la tabla o columna que falla y la aplicación o componente principal que aparece en el seguimiento de la pila. Por ejemplo, "la tabla no existe" es un error muy diferente de "demasiadas conexiones" o "el servidor MySQL se ha desconectado". Nextcloud enumera varios errores comunes de tipo SQLSTATE en su documentación general de solución de problemas .
El actualizador integrado reemplaza primero el código de Nextcloud. Las migraciones de la base de datos y de la aplicación son una fase aparte. En el modo de línea de comandos, el actualizador puede ejecutarse occ upgradeautomáticamente; de lo contrario, la migración debe completarse posteriormente. Esta distinción explica muchos casos en los que el actualizador parecía haber finalizado, pero la interfaz web normal devolvía una excepción de base de datos.
cd /var/www/nextcloud
sudo -E -u www-data php occ status
Si necesita proteger la instancia durante la resolución de problemas, active el modo de mantenimiento. Nextcloud describe el modo de mantenimiento como el modo destinado a las actualizaciones, ya que impide nuevos inicios de sesión y bloquea las sesiones activas.
sudo -E -u www-data php occ maintenance:mode --on
sudo -E -u www-data php occ status
Si el código se actualizó pero las migraciones no se completaron, ejecute el comando de actualización como el usuario HTTP:
cd /var/www/nextcloud
sudo -E -u www-data php occ upgrade
Observe la salida hasta que el comando indique que se realizó correctamente o se detenga ante un error específico. Si falla, solucione el problema antes de repetir el comando. Los problemas más comunes incluyen una aplicación incompatible, una versión de PHP/base de datos no compatible, un servicio de base de datos no disponible o permisos que impiden realizar las actualizaciones necesarias. No actualice repetidamente la interfaz web mientras la migración esté fallando.
La documentación de actualización de Nextcloud también advierte que no se deben omitir las versiones principales. Al actualizar entre versiones principales, se recomienda hacerlo de una en una.
maintenance:repairEjecuta los pasos de reparación de Nextcloud y también se ejecuta automáticamente durante las actualizaciones. Es recomendable ejecutarlo manualmente una vez que se haya corregido el problema que interrumpió la actualización.
sudo -E -u www-data php occ maintenance:repair
Esto es más seguro que inventar sentencias SQL porque los pasos de reparación los proporcionan el núcleo y las aplicaciones de Nextcloud. No es un reemplazo mágico para occ upgrade, y no solucionará un servidor de base de datos inactivo ni una versión de base de datos no compatible. El comando está documentado en Comandos de sistema y mantenimiento de Nextcloud .
Si el registro apunta a problemas de conectividad en lugar de esquema, verifique que el servicio de base de datos esté en funcionamiento y sea accesible desde el entorno PHP de Nextcloud. En un host MariaDB típico, una comprobación útil es:
sudo systemctl status mariadb
A continuación, revise la configuración de la base de datos config/config.php: tipo de base de datos, host, nombre de la base de datos, usuario y cualquier configuración de socket o puerto. Un error de socket Unix puede aparecer como "No existe tal archivo o directorio", mientras que una base de datos remota puede fallar debido a problemas de enrutamiento, DNS, TLS, reglas de firewall, credenciales o el propio servidor.
La compatibilidad de versiones es importante tras una actualización importante de Nextcloud. Para Nextcloud 35, las notas de la versión oficial indican que MariaDB 10.6 y MySQL 8.0 ya no son compatibles; los mínimos documentados son MariaDB 10.11 LTS y MySQL 8.4 LTS. Verifique los requisitos para su versión principal de Nextcloud antes de actualizar la base de datos de forma independiente. Consulte la sección «Actualización a Nextcloud 35» .
Nextcloud 35 añade una función db:schema:checkque compara el esquema en vivo con el esquema esperado por las migraciones de núcleo y aplicaciones instaladas. Es de solo lectura: informa de las diferencias sin modificar la base de datos.
sudo -E -u www-data php occ db:schema:check
sudo -E -u www-data php occ db:schema:check -v
Si la vista general del administrador o la salida del comando informa que faltan columnas opcionales, índices o claves primarias, utilice los comandos de mantenimiento documentados:
sudo -E -u www-data php occ db:add-missing-columns
sudo -E -u www-data php occ db:add-missing-indices
sudo -E -u www-data php occ db:add-missing-primary-keys
Cada uno admite --dry-runla vista previa del SQL. Estos comandos no deben usarse como sustituto de una migración de núcleo fallida. Si db:schema:checkse informan objetos inesperados o diferencias en las propiedades de las columnas, revise el hallazgo antes de realizar cualquier cambio; Nextcloud indica que algunos valores predeterminados de toda la base de datos están fuera del modelo de esquema esperado. La referencia autorizada de comandos es Comandos de base de datos y DAV de Nextcloud .
Si el rastreo de la pila menciona una aplicación no incluida en la versión principal, su migración podría ser incompatible con la nueva versión del servidor. La guía de solución de problemas de Nextcloud recomienda deshabilitar las aplicaciones de terceros o no incluidas en la versión principal para las actualizaciones y la resolución de problemas. Utilice los comandos de la aplicación disponibles en su versión instalada para deshabilitar la aplicación sospechosa desde la línea de comandos, vuelva a ejecutar el comando occ upgradey solo vuelva a habilitar la aplicación después de confirmar una versión compatible.
Esta rama es especialmente importante cuando las tablas principales parecen estar en buen estado, pero la excepción menciona un espacio de nombres de proveedor o una tabla perteneciente a una aplicación. Eliminar manualmente las tablas de esa aplicación es arriesgado, ya que podría destruir datos que la aplicación aún espera.
Una vez occ upgradefinalizado el proceso, las comprobaciones de reparación/esquema ya no mostrarán ningún problema que impida el correcto funcionamiento y el servicio de base de datos sea estable; desactive el modo de mantenimiento:
sudo -E -u www-data php occ maintenance:mode --off
A continuación, verifique la instancia por etapas: cargue la página de inicio de sesión, inicie sesión, abra Archivos, explore algunas carpetas, pruebe la carga y descarga de un archivo, revise la configuración de administración en busca de advertencias y examine las nextcloud.logentradas más recientes. Confirme también que las tareas programadas y en segundo plano se ejecutan con normalidad. El simple hecho de que la página de inicio se haya recuperado no garantiza que las migraciones de la aplicación, las operaciones de archivos y las tareas en segundo plano funcionen correctamente.
nextcloud.log, incluyendo SQLSTATE y el componente nombrado en el rastreo.occ statusla instancia y póngala en modo de mantenimiento durante la reparación.occ upgradepara finalizar las migraciones de aplicaciones y núcleos compatibles.maintenance:repairuna vez solucionado el fallo subyacente.db:schema:checken Nextcloud 35 y los db:add-missing-*comandos documentados cuando corresponda.Restaura desde una copia de seguridad válida y consistente internamente cuando la base de datos esté dañada, las migraciones hayan modificado parcialmente los datos de forma irreversible o se hayan eliminado tablas o datos necesarios fuera de Nextcloud. La base de datos, la configuración, el directorio de datos y la versión del código deben pertenecer a un punto de recuperación compatible. Si tienes soporte de pago para Nextcloud o se trata de una implementación crítica para el negocio, detén la operación antes de realizar modificaciones SQL destructivas y proporciona el registro completo, las versiones exactas de Nextcloud de origen y destino, el tipo y la versión de la base de datos, la versión de PHP y el resultado del occcomando correspondiente.
El principio fundamental es sencillo: un error de base de datos posterior a la actualización no justifica adivinar el código SQL. Deje que el registro identifique el fallo, finalice occ upgradelas migraciones previstas, utilice las herramientas de reparación y esquema de Nextcloud y valide la plataforma de base de datos antes de volver a abrir la instancia.
Compara 10 herramientas de escaneo de ping para la detección rápida de redes LAN, el escaneo multiplataforma y la gestión de direcciones IP. Descubre qué puede (y qué no puede) revelarte un escaneo.
Compare seis herramientas de gestión de red para la monitorización del rendimiento, incluyendo la cobertura SNMP, la asignación de mapas, las alertas, los modelos de implementación y las ventajas y desventajas en cuanto a costes.
Compara las mejores aplicaciones de análisis Wi-Fi para Windows, iPhone y Android, incluyendo herramientas para la congestión de canales, la cobertura de la señal, los mapas de calor y la resolución de problemas de red.
Compara siete monitores de ping gratuitos y de código abierto, desde suites de red completas hasta sondas de latencia específicas, y elige el que mejor se adapte a tus necesidades en cuanto a disponibilidad, pérdida de paquetes e historial.
Aprenda qué significa QoS en redes, cómo las marcas DSCP y las colas de tráfico priorizan las aplicaciones de voz, vídeo y empresariales, y qué problemas no puede solucionar la QoS.
Compare siete herramientas de administración de direcciones IP para el descubrimiento de subredes, la coordinación de DNS y DHCP, el inventario de red y la gestión de direcciones IP de código abierto.
Compara software de servidor SFTP fiable para Windows y Linux, incluyendo OpenSSH, Bitvise, SolarWinds y SFTPGo. Encuentra la solución ideal para tus necesidades de seguridad y transferencia de archivos.
Cree un sistema práctico de monitorización de red con una cobertura clara de los dispositivos, métricas de rendimiento útiles, alertas procesables y una comparación de SolarWinds NPM, PRTG y OpManager.
Compare las herramientas de escaneo de red para la detección rápida de dispositivos, escaneos de IP multiplataforma y gestión de direcciones IP (IPAM) empresariales, con orientación sobre cómo adaptar cada opción a su red.
Utilice la opción --traceroute de Nmap para asignar saltos a un host autorizado, comprender la salida de saltos y RTT, y solucionar problemas de respuestas faltantes sin realizar un escaneo excesivo.
