Solución de problemas de conexión a MySQL en ownCloud 10

Cuando ownCloud 10 muestre el mensaje "Error al conectar con la base de datos", primero identifique si MySQL no está disponible, si rechaza la cuenta o si falta un controlador PHP. Verifique el servicio de base de datos y el host exacto, el nombre de la base de datos y el nombre de usuario guardados en ownCloud config/config.php; luego, pruebe esas credenciales desde el servidor ownCloud antes de modificar los permisos o recrear cualquier configuración. Esta guía está dirigida a ownCloud Server 10.16 con MySQL o MariaDB. Las etiquetas de menú y los comandos de paquetes pueden variar según el sistema operativo y el método de instalación.

Entienda lo que le está diciendo el error.

El mensaje "Error de conexión a la base de datos" es genérico. El error más específico de MySQL o PHP en el registro de ownCloud o del servidor web suele indicar la causa. Un error de conexión como el error 2002 o 2003 de MySQL generalmente indica un servicio detenido, un socket o puerto incorrecto, una ruta de red bloqueada o un servidor que no está escuchando donde ownCloud espera. Un mensaje de "Acceso denegado" normalmente significa que MySQL recibió la conexión, pero no aceptó el nombre de usuario, la contraseña o el host del cliente.

MySQL se refiere al servidor de base de datos; MariaDB es una opción de base de datos compatible con ownCloud. PDO MySQL es el controlador de base de datos PHP que permite a ownCloud comunicarse con cualquiera de ellos. Acción: anote el texto exacto del error y la marca de tiempo, y compárelo con las comprobaciones que se indican a continuación, en lugar de interpretar cada fallo de conexión como una contraseña incorrecta.

Prepárese antes de cambiar la configuración.

  • Confirma si ownCloud y MySQL se ejecutan en la misma máquina, en máquinas diferentes o en contenedores separados.
  • Conozca la ruta de instalación de ownCloud, el host de la base de datos, el puerto o socket, el nombre de la base de datos y el nombre de usuario dedicado de la base de datos.
  • Mantén disponible una sesión de administrador o acceso a la consola. Realiza una copia de seguridad config/config.phpantes de editarla y nunca publiques la contraseña de la base de datos en una solicitud de soporte.
  • Ejecute los comandos como administrador solo cuando sea necesario. Reemplace los nombres y rutas de ejemplo con los valores de su instalación.

No elimine ni vuelva a crear la base de datos como primer paso para solucionar problemas: los archivos de usuario y los metadatos existentes dependen de ella. Acción: realice una copia de seguridad verificada tanto del directorio de datos de ownCloud como de la base de datos antes de realizar cualquier cambio a nivel de base de datos.

Verifique el servicio de base de datos y la ruta de conexión.

  1. Comprueba que MySQL o MariaDB se esté ejecutando. En un host Linux con systemd, inspecciona el servicio usando el nombre instalado en tu sistema:
sudo systemctl status mysql
sudo systemctl status mariadb

Es posible que un nombre de servicio no exista en su distribución. Si el servicio está detenido, revise su registro de errores y el registro de la base de datos para determinar la causa antes de reiniciarlo. Acción: resuelva los errores de inicio, como un disco lleno o una configuración de base de datos no válida, antes de solucionar problemas con las credenciales de ownCloud.

  1. Verifique el host y el puerto desde la máquina ownCloud. Pruebe la conectividad TCP con el host y el puerto de la base de datos, generalmente el 3306. Para una base de datos remota, confirme la resolución de nombres, las reglas del firewall y que MySQL esté escuchando en una interfaz accesible desde el servidor ownCloud. No exponga el puerto 3306 a internet.
  2. Comprenda la diferencia del socket localhost. En sistemas tipo Unix, un cliente MySQL que se conecta localhostsuele usar un socket Unix local; 127.0.0.1forzar TCP. Esto es importante cuando la base de datos es local, pero PHP y MySQL usan rutas de socket diferentes. Acción: compare la ruta del socket y la configuración del host con la configuración real del servidor de la base de datos, o pruebe TCP si esa es la ruta prevista.

Prueba el inicio de sesión desde el servidor ownCloud utilizando el mismo nombre de usuario, host y nombre de base de datos que utiliza ownCloud:

mysql --protocol=TCP -h db.example.net -P 3306 -u oc_user -p owncloud

Introduzca la contraseña cuando se le solicite; no la escriba directamente en el comando, ya que podría quedar registrada en el historial de la consola. Para una conexión de socket local, pruebe el host y el modo de socket que coincidan con su configuración. Un inicio de sesión exitoso demuestra que MySQL acepta esa ruta de conexión y cuenta, pero no demuestra que PHP tenga su controlador ni que ownCloud esté leyendo la misma configuración. Acción: si este comando falla, utilice el error de MySQL para seleccionar la siguiente comprobación.

Verifique la configuración de ownCloud, el controlador PHP y los privilegios.

El asistente de instalación de ownCloud escribe el tipo de base de datos, el nombre de la base de datos, el nombre de usuario, la contraseña, el host y el prefijo de la tabla en config/config.php. Revise los valores cuidadosamente sin copiar la contraseña en los registros o el chat. dbhostPuede incluir un host y un puerto; si dice localhost, verifique si el socket esperado está disponible para el proceso PHP.

Si el cliente de línea de comandos se ejecuta correctamente pero ownCloud sigue fallando, verifique que el entorno de ejecución de PHP utilizado por el servidor web esté pdo_mysqlinstalado y habilitado. Un comando de shell como este php -msolo informa sobre el entorno de ejecución de PHP de la CLI, que puede ser diferente de Apache o PHP-FPM. Acción: inspeccione la configuración activa de PHP web y reinicie el servicio web/PHP correspondiente después de habilitar la extensión.

Para el error "Acceso denegado", verifique que MySQL tenga una cuenta que coincida con el nombre de usuario y el host del cliente que ve la base de datos. MySQL trata las cuentas como 'oc_user'@'localhost'y 'oc_user'@'10.0.0.5'como distintas. Si la aplicación ownCloud está en un contenedor, la base de datos puede ver una dirección de contenedor o puente en lugar de localhost. Acción: solicite al administrador de la base de datos que inspeccione la cuenta y los permisos coincidentes; otorgue acceso solo desde el host o la red de ownCloud que lo necesite.

Confirma que la base de datos existe y que la cuenta de ownCloud puede usarla. Evita otorgar privilegios globales o usar la cuenta de administrador de MySQL en ownCloud. Los permisos necesarios pueden variar según se trate de una instalación inicial o una instancia existente. Acción: sigue las instrucciones de configuración de la base de datos de ownCloud para la etapa específica y no modifiques la propiedad ni los permisos de bases de datos no relacionadas.

Aplique una corrección y verifique la solución.

Corrija únicamente la configuración que identificaron las pruebas: inicie el servicio de base de datos, utilice el nombre de host y el puerto accesibles, corrija una discrepancia de socket, habilite el controlador PHP, corrija la contraseña de la cuenta o ajuste un permiso de base de datos específico del host. Si edita el archivo config/config.php, conserve la sintaxis PHP válida y realice una copia de seguridad primero. No cambie el nombre de la base de datos, el prefijo de la tabla ni las credenciales al azar.

Tras el cambio, recargue ownCloud y confirme que la página se carga sin la advertencia de conexión a la base de datos. Compruebe el registro de ownCloud para verificar que la solicitud se haya realizado correctamente y asegúrese de que los usuarios puedan explorar los archivos existentes. Si MySQL informa que el servidor se ha desconectado en lugar de un rechazo de conexión, se trata de un problema diferente relacionado con una conexión interrumpida o con un tiempo de espera agotado, o con el tamaño del paquete; ownCloud documenta la configuración de tiempo de espera y tamaño de paquete de MySQL para este caso. Acción: utilice la guía de solución de problemas de la base de datos correspondiente y modifique los límites del servidor solo cuando los registros respalden dicho diagnóstico.

La documentación actual de ownCloud Server 10.16 recomienda el asistente de instalación para la configuración estándar de la base de datos y menciona específicamente pdo_mysqlla ruta del socket MySQL como comprobaciones. Los nombres exactos de los paquetes, las versiones de PHP y los nombres de los servicios dependen del host. Acción: finalice repitiendo la prueba de conexión desde el servidor ownCloud y confirmando que la aplicación puede leer sus datos existentes.

Referencias oficiales

Dejar un comentario

Evita los tiempos de espera de bloqueo de archivos de ownCloud con el backend adecuado.

Distinga entre la contención de bloqueos de base de datos y los bloqueos WebDAV caducados, y luego elija y configure la solución adecuada para ownCloud 10.

Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Qué comprobar cuando ownCloud Web se abre en una página en blanco.

Mediante comprobaciones específicas, puede rastrear el problema de una pantalla web de ownCloud en blanco hasta la caché del navegador, la falta de recursos web, errores del servicio o la configuración de la URL del proxy inverso.

Borre la advertencia de memoria PHP de ownCloud en el entorno de ejecución correcto.

Establezca el límite de memoria PHP web de ownCloud, reinicie el servicio correspondiente y verifique el valor activo sin confundirlo con la configuración de la CLI o los límites de carga.

Solución de problemas de conexión a MySQL en ownCloud 10

Averigua si MySQL, PHP, la configuración de sockets o los permisos de la base de datos están bloqueando ownCloud 10 y, a continuación, verifica si existe una solución segura.

Establece un límite de caducidad estricto para los enlaces públicos de ownCloud.

Establece un límite de caducidad estricto para los enlaces públicos de ownCloud.

En ownCloud Classic, haga obligatoria la caducidad de los enlaces públicos, establezca una duración máxima y compruebe los recursos compartidos existentes que puedan necesitar una limpieza por separado.

Agregue el inicio de sesión de dos factores TOTP a ownCloud Infinite Scale con Keycloak.

Agregue el inicio de sesión de dos factores TOTP a ownCloud Infinite Scale con Keycloak.

Habilite TOTP a través de Keycloak, registre usuarios de forma segura y comprenda cuándo se aplican las configuraciones de MFA a nivel de ruta de Infinite Scale.

Restaura la sincronización de ownCloud haciendo coincidir el cliente con tu servidor.

Compruebe si el problema se debe a un fallo de compatibilidad entre OC10 y la versión 7.x o a un registro CSync dañado, y aplique la solución adecuada sin eliminar los archivos sincronizados.

Configura ownCloud con HTTPS usando Let's Encrypt y Nginx.

Configura ownCloud con HTTPS usando Let's Encrypt y Nginx.

Seleccione HTTP-01 o DNS-01, configure un proxy inverso de ownCloud y verifique que Certbot renueve automáticamente los certificados HTTPS.

Conecta ownCloud Infinite Scale a LDAP para el inicio de sesión de usuarios.

Configure el inicio de sesión LDAP de oCIS, alinee las búsquedas de usuarios y grupos, y verifique la configuración de TLS y del esquema antes de la implementación.

Conecta un bucket de S3 a ownCloud 10 como almacenamiento externo.

Conecta un bucket de S3 a ownCloud 10 como almacenamiento externo.

Agregue un bucket de Amazon S3 a ownCloud 10, prepare credenciales y puntos finales compatibles y verifique el acceso sin confundir un punto de montaje con el almacenamiento principal.