Revisado el 6 de octubre de 2026. Si la búsqueda de Zimbra devuelve resultados incompletos para un buzón y el registro del buzón indica un error del indexador o de Lucene, la solución habitual consiste en reconstruir el índice de búsqueda de ese buzón con zmprov rim account@example.com startel comando. Este comando recrea los datos del índice de búsqueda a partir del contenido del buzón; no soluciona problemas como la falta de archivos de mensajes, la corrupción de la base de datos, un volumen de almacenamiento lleno o fallos de búsqueda en todo el servidor.
El éxito se evalúa según el resultado real: la reindexación finaliza, las búsquedas dirigidas muestran mensajes que antes no aparecían y los nuevos correos siguen apareciendo en los resultados. El simple hecho de ejecutar el comando no garantiza la reconstrucción del índice. Planifique la tarea durante un período de menor actividad, verifique primero el volumen del índice y ejecútela para una cuenta afectada antes de ampliar el alcance.
¿Cuándo es la reindexación del buzón la solución adecuada?
Un índice dañado o incompleto es una causa probable cuando el acceso al buzón funciona, pero las búsquedas no muestran mensajes conocidos, el usuario afectado ve resultados de búsqueda inconsistentes o /opt/zimbra/log/mailbox.logrecibe mensajes como "Error al abrir el indexador" o una excepción de Lucene para esa cuenta. La documentación de solución de problemas de Zimbra zmprov verifyIndexdocumenta un índice que falta o no se puede abrir y lo utiliza zmprov rim ... startpara recrearlo.
Primero, determine el alcance del problema. Si solo un usuario se ve afectado, investigue ese buzón. Si varios usuarios del mismo servidor de correo presentan el mismo síntoma, verifique el estado del servidor, la capacidad de almacenamiento, las actualizaciones recientes y los registros antes de realizar múltiples reindexaciones. Un gran volumen de reindexaciones puede consumir una cantidad considerable de E/S de disco y CPU, y podría empeorar la lentitud de las búsquedas para otros usuarios.
La reindexación no es la primera medida adecuada cuando los usuarios no pueden iniciar sesión, faltan carpetas, los mensajes o archivos adjuntos no se abren, la base de datos del almacén de correo informa errores o el servicio de búsqueda no está disponible para varias cuentas. Estos indicios pueden señalar problemas con la base de datos, el almacén de blobs, el servicio o la infraestructura. Conserve los registros y utilice el procedimiento de recuperación de Zimbra o el canal de soporte correspondiente en lugar de considerar cada queja relacionada con la búsqueda como un problema de índice.
Antes de ejecutar el comando
- Confirme el buzón de destino: copie la dirección de la cuenta principal, no un alias. En una implementación con varios servidores de correo, verifique qué servidor de correo es el propietario de la cuenta y ejecute el comando según su topología y la versión de Zimbra instalada.
- Compruebe el espacio disponible: inspeccione el espacio libre y los inodos en el volumen de índice. Es posible que las instalaciones coloquen los datos del índice en un montaje independiente; no dé por sentado que la ruta predeterminada es la ubicación activa. Un volumen de índice lleno puede provocar fallos de indexación.
- Compruebe la carga del sistema: observe la latencia actual del servidor de correo, la actividad de la CPU y del disco. La reindexación consume muchos recursos, especialmente para buzones grandes, así que prográmela fuera de los momentos de mayor tráfico.
- Proteja la recuperabilidad: Confirme que el proceso de copia de seguridad habitual esté en buen estado y sea reciente antes del mantenimiento. La reindexación tiene como objetivo reconstruir los datos de búsqueda derivados, pero una copia de seguridad sigue siendo importante antes de cualquier reparación en el correo de producción.
- Comprueba la compatibilidad de comandos: la sintaxis de la CLI de Zimbra y las opciones disponibles pueden variar según la versión. Consulta la ayuda y la documentación de los comandos para la versión instalada, especialmente si utilizas una versión anterior o una implementación personalizada.
Cómo verificar y reconstruir un buzón de correo
1. Ejecute una comprobación de diagnóstico, si está disponible.
Como usuario del sistema operativo Zimbra, pruebe el buzón sospechoso con el diagnóstico que se muestra en la guía de solución de problemas de Zimbra:
zmprov verifyIndex user@example.com
Una respuesta que indique que el índice no existe o que no se encuentra un archivo de segmento respalda el diagnóstico de corrupción del índice. Si su versión instalada no reconoce el índice verifyIndex, no instale scripts ni copie archivos de índice de otro servidor para solucionarlo. Consulte la documentación de Zimbra específica de su versión y correlacione el registro del buzón con la cuenta afectada.
2. Iniciar la reindexación del buzón.
En el servidor Zimbra correspondiente, cambie a la cuenta del sistema operativo Zimbra e inicie la reconstrucción del buzón afectado:
su - zimbra
zmprov rim user@example.com start
Normalmente, el comando indica que la tarea ha comenzado. Esto confirma el envío, no la finalización. No inicie tareas repetidas solo porque la búsqueda quede incompleta inmediatamente después; primero revise el estado de la tarea y los registros del almacén de correo.
3. Comprobar el progreso
Consulta la tarea de reindexación utilizando la misma cuenta y el mismo contexto del servidor:
zmprov rim user@example.com status
Repita la operación a intervalos razonables en lugar de consultar continuamente. Lea la respuesta según su versión de Zimbra: la interfaz de línea de comandos (CLI) informa sobre el estado de la tarea, mientras que la otra mailbox.logpuede proporcionar información sobre el progreso o los errores específicos de la cuenta. Si el comando informa un error, la tarea no se completa o los registros muestran fallos de espacio en disco o del escritor de índices, pause la ejecución y resuelva el problema subyacente antes de volver a intentarlo.
Las listas de referencia de comandos de Zimbra reIndexMailboxincluyen las acciones start, status, y cancel. Si su versión admite la cancelación y el trabajo está afectando el servicio, confirme la sintaxis local antes de usarla. No finalice los procesos Java ni elimine los archivos de índice como alternativa a un procedimiento de cancelación compatible.
Cómo confirmar que la reparación funcionó
Una vez finalizada la tarea, realice una prueba desde el cliente web del usuario afectado con algunos mensajes conocidos. Busque un remitente, asunto y rango de fechas distintivos; verifique tanto los mensajes antiguos como los recientes. Compruebe las carpetas donde deberían aparecer los mensajes y compare el resultado con un mensaje conocido que el usuario pueda abrir directamente. A continuación, envíe o reciba un mensaje de prueba y confirme que se puede buscar tras el tiempo de indexación habitual.
Busque una mejora sostenida en lugar de una única consulta exitosa. Los criterios prácticos de éxito son:
- El estado de reindexación del buzón alcanza su estado completado sin errores recurrentes.
- Mensajes conocidos que antes no aparecían aparecen en las búsquedas esperadas.
- Siguen llegando nuevos correos al índice de búsqueda.
- El volumen del índice mantiene una capacidad libre adecuada y los demás buzones de correo siguen funcionando correctamente.
Si el comando indica que se completó correctamente, pero faltan mensajes específicos, verifique que aún existan y que se puedan abrir. Compruebe si los términos de búsqueda del usuario, los filtros de fecha, el ámbito de la carpeta o la caché del cliente explican la diferencia. Un índice reconstruido no puede recuperar los mensajes que se eliminaron, nunca se entregaron o se perdieron del almacenamiento subyacente.
Cuándo cambiar la ruta de solución de problemas
Si la reconstrucción falla repetidamente, primero solucione el error que aparece en los registros. Confirme el espacio en disco y los inodos disponibles, compruebe si hay errores más generales en el almacén de correo o la base de datos y asegúrese de que el buzón se esté gestionando en el servidor correcto. Si la cuenta no puede acceder al contenido de los mensajes o si otros buzones presentan el mismo problema, detenga la reindexación e investigue la causa a nivel de almacén, base de datos o servidor.
Evite eliminar /opt/zimbra/indexdatos manualmente de forma rutinaria. La wiki pública de Zimbra incluye un procedimiento para eliminar manualmente el archivo de índice, pero esta página está en desarrollo y corresponde a versiones anteriores. La eliminación manual es más propensa a errores que el comando de reindexación a nivel de cuenta compatible y solo debe considerarse siguiendo las directrices del proveedor para la versión actual, con la ruta exacta del buzón, copias de seguridad verificadas y un plan de mantenimiento.
Límites de la reindexación de buzones de correo
La reindexación reconstruye los metadatos de búsqueda; no repara las tablas de MySQL ni de MariaDB, no restaura los blobs que faltan, no corrige un sistema de archivos dañado, no libera espacio en el disco ni soluciona una interrupción generalizada de la búsqueda en el servidor. Además, el proceso se prolonga a medida que aumenta el tamaño del buzón y la carga del servidor. La búsqueda puede quedar temporalmente incompleta mientras se ejecuta la indexación, y el rendimiento general puede disminuir durante la tarea.
Utilice primero la función de reindexación integrada a nivel de buzón cuando la evidencia apunte al índice de búsqueda de una cuenta. Evalúe el resultado con mensajes conocidos y correos de seguimiento. Si la reindexación no se completa o los datos están dañados, pase al procedimiento de recuperación de almacenamiento o base de datos correspondiente en lugar de proceder a la eliminación general del índice.
Referencias oficiales