Solucionar problemas de vista previa y publicación

Empareja los estados de tienda, compilación, publicación, checkout y dominio con la acción de recuperación más segura.

Ruta de entrada: Espacio de trabajo → selecciona una tienda → Escaparate → reproduce el estado de vista previa o publicación que se muestra en pantalla

Qué cubre esta guía

Identifica qué capa está fallando—versión del proyecto, vista previa, comprobación de compilación, publicación, catálogo público, checkout o dominio—y toma la acción de recuperación más pequeña y segura.

Por qué esta distinción es importante

El viaje de la tienda tiene varias capas independientes. Repetir Publicar no puede corregir datos de producto faltantes, y actualizar la vista previa no puede reparar una conexión de pago. Comienza con el mensaje exacto y la superficie que falló.

Disponibilidad y requisitos previos

Mantén el proyecto abierto y anota la etiqueta de versión actual.
Registra el mensaje exacto, la ruta de página y si falló en la vista previa o en la URL pública.
Espera a que el trabajo activo de Runner alcance Completado, Fallido o Detenido antes de iniciar una acción de recuperación conflictiva.
No elimines dominios, restaures versiones o repitas acciones pagadas solo para probar una teoría.

Encuentra la capa que falla

En Escaparate, verifica si existe una versión actual.
Confirma si la vista previa normal se abre.
Si estás publicando, lee el resultado de la comprobación de compilación antes de seleccionar otra acción.
Si la publicación tiene éxito, abre la URL pública en lugar de la URL de vista previa.
En la tienda pública, prueba el catálogo y el carrito.
Verifica el estado de checkout de Runner y la ruta de checkout real.
Si solo la dirección personalizada falla, verifica la Configuración de Dominio al final.

Controles de recuperación importantes

Control	Qué sucede cuando se selecciona
Actualizar en la vista previa	Recarga la vista previa actual y borra la selección activa del Modo Diseño y la sesión de deshacer/rehacer. Guarda las ediciones directas pendientes primero.
Corregir / Corregir error	Envía el diagnóstico de vista previa mostrado a Runner como una solicitud de reparación. Descartar solo oculta el mensaje.
Corregir con IA	Cierra la confirmación de publicación y envía su falla de compilación a Runner para reparación; la publicación no comienza.
Reintentar comprobación	Ejecuta la comprobación de compilación de la tienda nuevamente después de que Runner no pudo alcanzar el workspace.
Abrir Operaciones de la tienda	Cierra la confirmación de publicación y abre Operaciones de la tienda para que puedas completar la configuración nombrada.
Volver a comprobar la configuración	Verifica nuevamente la disponibilidad de Operaciones de la tienda después de que su estado no estaba disponible.
Republicar	Inicia un intento de publicación verificado nuevo después de un resultado fallido o sin enlace. Corrige la causa nombrada primero.
Volver a comprobar el pago	Verifica nuevamente una conexión de pago habilitada; no prueba un producto, envío o el formulario de checkout.

Referencia de estado a acción

Mensaje o síntoma	Capa	Qué significa	Acción más segura
Aún no hay tienda	Versión del proyecto	No existe una versión previsualizable.	Pídele a Runner que construya la primera tienda.
Construyendo la primera versión…	Versión del proyecto	Runner aún la está creando.	Sigue el progreso de la tarea; no publiques aún.
Error de compilación en una versión	Versión del proyecto	Esa versión no está lista.	Abre los detalles de la tarea y pídele a Runner que repare la falla.
Preparando la vista previa…	Vista previa	Runner está iniciando la vista previa seleccionada.	Mantén la versión más reciente seleccionada; actualiza solo si el progreso se detiene.
No se pudo cargar la vista previa de esta versión	Vista previa	La versión seleccionada no se pudo mostrar.	Vuelve a la actual, actualiza o intenta otra versión lista.
Reconectando la vista previa	Vista previa	Runner perdió la conexión de vista previa e intenta nuevamente.	Sigue el recuento de reintentos; reconecta el workspace si la recuperación falla.
Barra de error de vista previa con Corregir	Vista previa	La página en ejecución reportó un diagnóstico que Runner puede usar.	Selecciona Mostrar más para inspeccionarlo, Corregir o Corregir error para enviarlo a Runner, o Descartar solo para ocultar la barra.
Página no encontrada	Ruta de vista previa o pública	La ruta no existe en esa versión.	Vuelve a `/`, usa navegación visible y pídele a Runner que cree o repare la ruta.
El modo de diseño no se inició	Modo Diseño	La vista previa editable no se volvió lista.	Selecciona Intentar de nuevo, o vuelve a la vista previa actual y actualiza.
Editor visual deshabilitado mientras la IA está procesando	Modo Diseño	Runner está manejando otra solicitud.	Espera a que Runner termine.
No se pudo cargar el historial de versiones	Historial de versiones	La solicitud de lista de versiones falló.	Selecciona Intentar de nuevo.
La restauración está bloqueada	Historial de versiones	Runner está activo o la versión no está lista.	Espera a Runner, luego elige una versión lista.
No pudimos acceder a tu espacio de trabajo	Comprobación de publicación	Runner no pudo ejecutar la comprobación de compilación.	Selecciona Reintentar comprobación; reconecta el workspace si se repite.
Algo salió mal al compilar tu tienda	Comprobación de publicación	La tienda actual no puede pasar la compilación.	Selecciona Corregir con IA, revisa la reparación, luego vuelve a ejecutar las comprobaciones.
La configuración de la tienda está incompleta	Configuración de publicación	Detalles operativos importantes de la tienda permanecen sin terminar.	Selecciona Abrir Operaciones de la tienda. Reconoce solo si la limitación es intencional.
No pudimos verificar Operaciones de la tienda	Configuración de publicación	El estado de configuración es desconocido.	Selecciona Volver a comprobar la configuración antes de considerar un reconocimiento.
No se detectaron cambios de código	Cambios de publicación	Runner no encontró nada nuevo desde la última publicación.	Cancela, o reconoce un nuevo despliegue del mismo estado solo cuando sea intencional.
La integración de pagos no está configurada	Configuración de checkout	Algunos flujos de publicación muestran esto antes del lanzamiento cuando no se encuentra una conexión de pago habilitada.	Conecta Stripe; usa el reconocimiento solo para un lanzamiento de solo navegación intencional. Otros flujos informan el estado de checkout después de la publicación.
Error al publicar la tienda	Publicación	El intento no se completó.	Repara el problema nombrado, luego selecciona Republicar.
Enlace de la tienda no disponible	Entrega de publicación	El intento terminó sin una URL pública utilizable en Runner.	Cierra el diálogo, confirma que el workspace esté listo, luego selecciona Republicar.
La tienda pública muestra contenido antiguo	Publicación o versión	Los cambios del proyecto más reciente no están en vivo.	Confirma la versión actual más reciente, selecciona Publicar Cambios y reabre la URL pública.
Producto faltante en tienda pública	Catálogo	La publicación tuvo éxito, pero el producto previsto no es visible.	Verifica el estado del producto, mercado, precio e inventario; publica cambios si es necesario.
Acción de carrito faltante o deshabilitada	Catálogo o disponibilidad	El elemento seleccionado actualmente no se puede agregar.	Verifica opciones requeridas, disponibilidad, stock, precio y región.
Pago pausado	Pago	El flujo posterior a la publicación no encontró una conexión de Stripe habilitada.	Selecciona Conectar Stripe, luego prueba nuevamente la ruta de checkout real.
Estado de pago no disponible	Estado de pago	Runner no puede confirmar la disponibilidad de pago.	Selecciona Volver a comprobar el pago y prueba el checkout público independientemente.
El dominio personalizado dice Mal configurado	Dominio	Los registros DNS esperados no se verifican.	Copia los valores DNS mostrados exactamente a tu proveedor, luego verifica nuevamente.
Transferencia en curso	Dominio	Un dominio se está moviendo entre tiendas.	No inicies otra transferencia; sigue el estado mostrado.

Reporta un problema a Runner

Incluye estos detalles en un mensaje:

la ruta de página exacta o URL pública;
si falló en la vista previa o en la tienda en vivo;
la etiqueta de versión actual;
el texto de error o estado exacto;
el último botón que seleccionaste;
el resultado esperado; y
si el problema se reproduce después de la acción de reintento documentada.

Para un problema visual, incluye el diseño del dispositivo y una captura de pantalla. Para checkout, detente antes de un cargo real e informa el último paso exitoso.

Límites de recuperación

No reanudes ni republiques repetidamente un estado fallido sin cambios. Corrige la causa nombrada primero.
No restaures una versión anterior mientras Runner está trabajando.
No elimines un dominio para corregir un problema de tienda o checkout.
No reclames éxito de lanzamiento hasta que la URL pública, catálogo previsto, carrito y paso de checkout requerido hayan sido verificados cada uno.