14. Algo salió mal al instalar o usar

Busca la frase que ves (un error en rojo, una página en blanco, un menú que falta) y sigue "Qué hacer". Cada punto viene de un problema que ocurrió en una instalación real. Si sigue sin funcionar, envía el texto exacto del error (o una captura) a [email protected]. Te ayudaremos y añadiremos el problema a esta página, para que el próximo cliente pueda resolverlo solo.

Antes de ejecutar cualquier comando: haz una copia de seguridad (exportación de la base de datos y copia de la carpeta app/code). No pruebes en una tienda real sin ella.

A. Durante la instalación

1. La instalación se detiene en "You do not have the SUPER privilege and binary logging is enabled"

2. Un comando muestra generated/code/Magento cannot be deleted

3. Toda la tienda deja de abrir: 404, "File not found", "Primary script unknown", "Permission denied"

4. No aparece el menú GetDropFlow, Selección de productos ni Lista de importación en el administrador

5. La tienda se ve rota, o la página de producto o el pago no funcionan

6. Errores extraños después de actualizar

B. Primera configuración

7. Los ajustes dicen "Tu licencia no está activa, estos ajustes son de solo lectura"

Para comparar: una licencia activa

Recuadros rojos: ① Licencia ✓Válida; ② Estado: Válida; ③ la fecha Válida hasta.

8. "Conectar AliExpress" dice que la dirección del administrador no es https, o que la dirección no tiene un dominio real

9. El inicio de sesión de AliExpress falla o pide verificación sin parar

C. Uso diario

10. Publiqué productos pero no los veo en la tienda

11. No aparece el costo de envío en el carrito

Envío en vivo en los métodos de envío

Recuadros rojos: ① el bloque GetDropFlow envío en vivo (AliExpress); ② Activado está en No: póngalo en Sí; ③ la nota de debajo.

12. La conexión con AliExpress deja de funcionar tras unos dos meses

Para comparar: AliExpress conectado

Recuadros rojos: ① Cuenta de AliExpress ✓Conectado; ② el aviso verde con el fin estimado de la autorización; ③ el botón Conectar de nuevo (reautorizar).

13. No sé qué salió mal

La página de registros

Recuadros rojos: ① las claves, tokens, direcciones y correos están ocultos: puede hacer una captura sin riesgo; ② la columna Nivel del registro: WARNING es un aviso, ERROR un error; ③ por ejemplo esta línea: la licencia no está configurada (vea el punto 7).

14. bin/magento dice pdo_mysql extension is not installed

15. El instalador se detiene con "GetDropFlow was installed with Composer" o "bin/magento cannot load the shop"

16. El script de instalación/actualización se detiene al principio con "is not allowed to change" (permisos)

17. Tras una actualización o restauración, las páginas del admin de un idioma no tienen estilos

18. Una restauración o actualización se detuvo y la tienda sigue en modo mantenimiento ("cannot delete generated/code")

19. La imagen pequeña del carrito es la del producto padre (por ejemplo el vestido rojo), no la del color que elegí

1. En el administrador vaya a Tiendas (Stores) → Ajustes (Settings) → Configuración (Configuration). 2. A la izquierda abra Ventas (Sales) → Pago (Checkout). 3. Despliegue Carrito de compras (Shopping Cart) y busque Imagen del producto configurable (Configurable Product Image) (si está marcado «Usar valor del sistema», desmárquelo primero). 4. Elija Miniatura del propio producto (Product Thumbnail Itself) en lugar de Miniatura del producto padre (Parent Product Thumbnail). 5. Pulse Guardar configuración, actualice la caché en Sistema → Administración de caché y vuelva a añadir el producto al carrito.

20. El registro muestra una ronda de «sincronización de precios y existencias» omitida

Mensaje: «Se omitió una ronda de la sincronización automática de precios y existencias porque se estaban reemplazando los archivos de GetDropFlow». En ese momento había una actualización: el modo de mantenimiento no detiene las tareas programadas de Magento, así que una ronda encontró los archivos a medio reemplazar. No hay que hacer nada: la siguiente ronda se ejecuta sola unos minutos después. (Antes de 0.2.22 el mismo caso se anotaba como ERROR con una línea como Class ... SyncResult not found; significa lo mismo.) Si vuelve una y otra vez sin que haya una actualización, avísenos.

21. La búsqueda de productos dice «La búsqueda falló» o encuentra productos que no corresponden a las palabras

«La búsqueda falló. AliExpress no envió resultados para estas palabras y no dio ningún motivo.» AliExpress respondió «unknown error» a esta búsqueda (las mismas palabras pueden funcionar un minuto después, y otras palabras funcionan). Espere un minuto y busque de nuevo, o pruebe otras palabras. Si todas las búsquedas fallan, abra Registros y cuéntenos lo que dice la línea «search failed». Resultados que no corresponden (fusibles, diodos...): escribió palabras en chino. Esta búsqueda de AliExpress funciona con palabras en inglés; busque de nuevo en inglés, por ejemplo summer dress. (Comprobado en la tienda de prueba: summer dress dio 51217 resultados adecuados; las palabras chinas de lo mismo dieron 12669 resultados encabezados por fusibles y diodos. No se sabe si AliExpress tiene un ajuste que haga funcionar el chino (SIN VERIFICAR); la búsqueda envía el idioma en_US.)

22. El pago ofrece solo «Free Shipping $0.00» (y no «Standard shipping»)

«Free Shipping - Free» no es un método de GetDropFlow: es el método de entrega Envío gratuito propio de Magento. GetDropFlow solo puede mostrar $0.00 por su cuenta cuando usted fija un umbral de envío gratis o cuando AliExpress mismo dice que el envío es gratis, y entonces la línea se llama como el otro método de GetDropFlow («Standard shipping ...»). Además, GetDropFlow oculta todos los demás métodos (Envío gratuito, Tarifa plana, Tarifas por tabla) en un carrito con productos de GetDropFlow, cuando su propio envío está activado y el ajuste «ocultar otros métodos» está activado. Si solo ve Free Shipping, se da una de estas tres cosas: el envío de GetDropFlow está desactivado, «ocultar otros métodos» está desactivado o el carrito no se reconoció como carrito de GetDropFlow. Compruebe en Tiendas → Configuración → Ventas → Métodos de entrega que GetDropFlow live shipping (AliExpress) → Enabled esté en Yes, que Hide the store's other shipping methods for GetDropFlow products esté en Yes y que Free Shipping esté en No (en la tienda donde se vio estaba activado, en la que mostraba «Standard shipping $2.39» no; cuál de las tres causas fue no está verificado, SIN VERIFICAR). Después vacíe la caché y pruebe con un carrito nuevo.

23. La página del producto y la lista de búsqueda muestran el precio antiguo, pero el carrito cobra el nuevo

Causa: Magento guarda las páginas de producto en archivos de caché. Tras un cambio de precio, a veces no se puede borrar la página antigua: el "índice de etiquetas" de la caché pierde entradas cuando varios procesos escriben a la vez, y bin/magento cache:flush no encuentra esos archivos (algunos duran 30 días). Qué hacer: en la raíz de Magento, con el usuario del sitio, ejecute php bin/magento cache:flush; si el precio en la tienda sigue siendo el antiguo, vacíe los archivos dentro de var/cache y var/page_cache (solo los archivos, no las carpetas) y abra la página de nuevo. Desde la 0.2.24 el plugin borra por sí mismo los archivos de caché antiguos del producto después de cambiar su precio. (captura pendiente)

24. Un producto nuevo se abre, pero no está en la categoría ni en la búsqueda

Causa: los índices de categoría, precio, stock y búsqueda de Magento a veces omiten un producto recién publicado. Algunos productos también carecen de una fila en el índice de precios. Qué hacer: ejecute php bin/magento indexer:reindex catalog_product_price cataloginventory_stock catalog_category_product catalogsearch_fulltext y luego php bin/magento cache:flush. Tarda unos minutos y no cambia productos ni precios. Un producto con stock 0 en todas sus variantes se oculta en la tienda por diseño; no es un fallo. (captura pendiente)

25. Los correos de pedido muestran el remitente example.com, o los clientes no los reciben

Revise en este orden: ① que el remitente en Tiendas → Configuración → Ventas → Correos de ventas y Direcciones de correo de la tienda sea una dirección de su propio dominio; ② que el servidor pueda enviar correo: con Google Workspace, permita la IP de su servidor en el "servicio de retransmisión SMTP" de la consola de administración de Google, envíe a través de él desde el programa de correo del servidor (por ejemplo postfix), use su dominio como nombre de saludo y fije el remitente del sobre a su correo de soporte; ③ busque en el registro de correo "bounced" y el motivo. No necesita usuario y contraseña SMTP en Magento: basta el método "Sendmail".

26. El usuario y la contraseña SMTP del administrador de Magento fueron rellenados por el navegador con su cuenta de correo

Navegadores como Chrome rellenan en la página de ajustes una contraseña de correo guardada, y al guardar queda en la configuración de la tienda. Qué hacer: vacíe el usuario y la contraseña en los ajustes de correo (SMTP) y guarde; borre en el gestor de contraseñas del navegador la contraseña guardada de esta dirección; si la contraseña ya apareció en la configuración, cámbiela en ese buzón.

27. Una actualización o corrección urgente se detiene en la compilación con "Directory not empty"

Los archivos que el sitio generó mientras funcionaba bloquean la compilación. Qué hacer: como root, vacíe generated/code/* y generated/metadata/*, ejecute setup:di:compile, vacíe la caché y desactive el modo mantenimiento. Los scripts de actualización y de corrección incluyen este paso desde la v2 y lo restauran todo si falla.

28. Muchos errores en el catálogo de Pinterest o de Google

Lea primero el código de error en la página de diagnóstico; no cambie cosas a ciegas. Lo que hemos visto: el error 1008 de Pinterest (la plataforma dice "dificultad técnica") y la advertencia 1306 (imágenes adicionales limitadas por velocidad, HTTP 429); avisos de Google de "contenido para adultos" o "identidad y creencias", a menudo por palabras como sheer, see through, nude o una cruz en el título. Cómo comprobarlo: asegúrese de que las páginas y las imágenes se abren con normalidad y busque 429 en el registro web del servidor (en CloudPanel está en logs/nginx-production/access.log del sitio; las imágenes y los archivos estáticos no se registran por diseño). Qué hacer: espere a la próxima ingesta para ver si siguen los errores propios de la plataforma; cambie el título de los productos de riesgo o desactívelos; reduzca las imágenes adicionales si son demasiadas.

29. Dónde están los registros

Los registros del sitio en CloudPanel están en /home/<usuario del sitio>/logs/nginx-production/access.log y error.log. El sitio con el nombre de host del servidor tiene otro logs/nginx/ casi vacío; no mire ese. Antes de leer un registro, compruebe en la configuración de nginx adónde apunta access_log.

Cuando nos pidas ayuda, cuéntanos

  1. En qué paso estabas y qué pulsaste; 2. el error en rojo de la pantalla (texto o captura); 3. tu versión de Magento, de PHP (php -v) y el nombre de tu proveedor o panel; 4. las últimas líneas de la página de Registros.

Contacto

[email protected]


Español redactado por IA, pendiente de revisión por un hablante nativo. Esta página crece con cada problema nuevo que encuentran los clientes.

Rechazado o suspendido por Google Merchant Center

Vea "Rechazado o suspendido: qué hacer" al final del tutorial 15.