Reparar error duplicado WordPress: guía rápida

Hay pocas cosas tan frustrantes como intentar publicar una entrada y que el sistema te devuelva un error críptico. Si necesitas reparar error duplicado WordPress porque tu sitio muestra el mensaje «WordPress database error Duplicate entry», respira profundo. Es un problema clásico en la gestión de bases de datos MySQL o MariaDB, y aunque pueda asustar, tiene solución. Este fallo suele bloquear la actualización de plugins o el guardado de configuraciones porque el sistema intenta insertar un identificador que ya está ocupado. Vamos a diseccionar qué está pasando y cómo arreglarlo.

¿Qué significa el error Duplicate Entry?

Básicamente, tu base de datos está gritando que hay una colisión. Este error aparece cuando WordPress intenta escribir una fila violando una regla de unicidad, casi siempre la clave primaria (PRIMARY KEY). En una instalación estándar, cada fila de las tablas principales (wp_posts u wp_options) necesita un identificador único (ID). Es como un número de pasaporte: no puede haber dos iguales. Si el contador automático (auto_increment) se desincroniza o existe un registro duplicado por corrupción, la base de datos rechaza la consulta.

El mensaje completo suele verse así: Duplicate entry 'X' for key 'PRIMARY' o a veces Duplicate entry 'X' for key 'option_name'.

Pasos para reparar error duplicado WordPress

Para salir de este atolladero, hay que ir al grano y tocar el núcleo de la base de datos. Dependiendo de la tabla afectada, los pasos cambian un poco, pero la lógica es siempre la misma: restaurar el orden de los índices.

Método 1: Corregir el valor AUTO_INCREMENT

>La causa más frecuente es un desajuste en el auto_increment. Piensa en esto: si tienes una entrada con el ID 100, pero el contador interno de la tabla está atascado en 90, al crear algo nuevo intentará usar el 91. Si ese número ya existe por una operación fallida anterior, chocará de inmediato.

Sigue estos pasos para corregirlo:

1. Entra a tu panel de hosting (cPanel, Plesk) o conecta por SSH y abre phpMyAdmin.
2. Selecciona la base de datos de tu sitio.
3. Encuentra la tabla que da el error (suele ser wp_posts o wp_options).
4. Ve a la pestaña Operaciones arriba del todo.
5. Busca «Opciones de tabla» y encuentra el campo «Auto_increment».
6. Cambia el valor manualmente. Pon un número mayor que el ID más alto que exista ahora mismo. Por si acaso, sube un poco más (si el máximo es 150, pon 151 o directamente 200).
7. Dale a Continuar.

Método 2: Localizar y eliminar el duplicado

A veces el contador está bien, pero hay un registro repetido de verdad. He visto esto a menudo en la tabla wp_options, donde algunos plugins, al guardar configuraciones, crean filas gemelas sin querer.

1. En phpMyAdmin, ve a la pestaña SQL.
2. Para comprobar si hay duplicados en wp_options, ejecuta:

   SELECT option_name, COUNT(*) as count FROM wp_options GROUP BY option_name HAVING count > 1;

3. Si ves resultados, esos son los nombres de las opciones que están duplicadas.
4. Para borrar el duplicado y quedarte con el ID más antiguo (que suele ser el correcto), usa una consulta de eliminación. Ojo: haz backup antes de tocar nada.

   DELETE t1 FROM wp_options t1 INNER JOIN wp_options t2 WHERE t1.option_id < t2.option_id AND t1.option_name = t2.option_name;

Usar la herramienta de reparación de WordPress

Si lo anterior no funciona y sospechas que la tabla está más dañada de lo que parece, WordPress trae un script de reparación propio que puede salvarte el día.

1. Accede a los archivos de tu instalación por FTP o gestor de archivos.
2. Descarga el archivo wp-config.php y ábrelo para editarlo.
3. Añade esta línea justo antes de donde dice "¡Eso es todo, no edites más!":

   define('WP_ALLOW_REPAIR', true);

4. Sube el archivo modificado.
5. Entra a: https://tu-dominio.com/wp-admin/maint/repair.php.
6. Tienes dos opciones. Elige "Reparar base de datos" para corregir las tablas corruptas.
7. Muy importante: cuando acabes, borra esa línea del wp-config.php. No la dejes ahí por seguridad.

Prevención y mantenimiento

Una vez que logres reparar error duplicado WordPress, mejor pongamos medidas para que no te vuelva a pasar.

• Limpia las revisiones: Demasiadas revisiones antiguas inflan la base de datos y pueden favorecer estos errores de índice. Usa un plugin de limpieza o limita el número en el wp-config.php.
• Optimiza de vez en cuando: Usa un plugin tipo Optimizador de Base de Datos o ejecuta OPTIMIZE TABLE en phpMyAdmin cada pocos meses.
• Copias de seguridad: Esto es obligatorio. Antes de lanzar consultas SQL manualmente, haz un backup completo. Un fallo tipográfico en una consulta puede borrar datos críticos en segundos.

Consideraciones sobre tablas InnoDB

Casi todas las instalaciones modernas usan el motor InnoDB. Es más robusto que el viejo MyISAM, pero es muy estricto con el manejo de "auto_increment". Si intentas insertar un valor 0 en un campo auto_increment, InnoDB intentará usar el siguiente valor disponible, algo que en versiones antiguas se comportaba de forma distinta. Asegúrate de que tus plugins y temas están actualizados para evitar que intenten forzar inserciones de IDs que no tocan.

Conclusión

El error de entrada duplicada es un contratiempo técnico molesto, pero generalmente fácil de resolver si tienes acceso a la base de datos. La mayoría de las veces, con solo corregir el AUTO_INCREMENT el problema desaparece y puedes volver a publicar sin interrupciones. Si tras intentar estos pasos el error persiste o no te sientes cómodo ejecutando comandos SQL, el problema podría venir de una configuración avanzada del servidor o un conflicto de plugins más enrevesado. En RedServicio (redservicio.net) tenemos administradores de sistemas expertos listos para diagnosticar y reparar tu base de datos de forma segura, garantizando que tu sitio web siga estable.