Cómo Solucionar el Error de Excepción en URL Rewrites en Magento 2 Paso a Paso

Introducción al Error de URL Rewrites en Magento 2

Uno de los problemas más frustrantes a los que se enfrentan los administradores de tiendas e-commerce en Magento 2 es el error de excepción relacionado con las reescrituras de URLs (URL Rewrites). Este fallo suele manifestarse al intentar guardar un producto, categoría o al ejecutar la reindexación mediante la línea de comandos, arrojando un mensaje de excepción crítico debido a entradas duplicadas en la base de datos.

Causas Principales del Error

El origen de este problema generalmente se debe a inconsistencias en la tabla url_rewrite de la base de datos. Las causas más comunes incluyen:

• Intentos de crear una URL amigable que ya existe en la base de datos para otra entidad.
• Registros huérfanos dejados por productos o categorías eliminados incorrectamente.
• Interrupciones durante procesos previos de indexación masiva.

Método 1: Limpiar la tabla url_rewrite mediante SQL

La forma más directa de solucionar este conflicto es limpiar los registros duplicados o corruptos directamente en la base de datos. Sigue estos pasos con precaución:

1. Accede a tu gestor de base de datos (como phpMyAdmin) o mediante la terminal SSH.
2. Realiza una copia de seguridad completa de la base de datos de tu tienda Magento.
3. Ejecuta la siguiente consulta SQL para vaciar la tabla de reescrituras (no afecta a los datos de productos, solo a las rutas): TRUNCATE TABLE url_rewrite;
4. Vuelve a la terminal SSH y ejecuta el comando de indexación para regenerar las URLs limpias: php bin/magento indexer:reindex

Método 2: Regenerar URLs con herramientas de terceros o comandos

Si prefieres no manipular directamente las tablas SQL, puedes utilizar comandos específicos del framework o extensiones especializadas:

1. Abre tu consola SSH y navega hasta el directorio raíz de tu instalación de Magento 2.
2. Limpia la caché actual del sistema para evitar conflictos temporales ejecutando: php bin/magento cache:clean
3. Ejecuta la regeneración forzada de URLs usando módulos nativos o herramientas CLI de terceros compatibles con tu versión de Magento.
4. Verifica el estado de los indexadores con el comando: php bin/magento indexer:status asegurándote de que el proceso de URL Rewrites finalice sin excepciones.