Solución de problemas
Fallos comunes de configuración y ejecución.
Empieza por el entorno objetivo, luego comprueba las credenciales y después inspecciona la evidencia. La mayoría de los fallos se deben a que la ejecución apunta a la URL incorrecta, falta acceso a la previsualización, datos de prueba obsoletos o aserciones demasiado amplias.
URL de previsualización no disponible
Mueve el paso de Autonomy después del paso de despliegue y confirma que la URL de previsualización se exporta al entorno de CI.
La autenticación falla durante el registro
Usa contraseñas generadas de alta entropía y verifica que el dominio de la bandeja de entrada es aceptado por el proveedor de autenticación.
Falso positivo en formulario intermedio
Añade una comprobación de estado final que rechace formularios activos de registro, contraseña, OTP o pago.
Falta el comentario en la pull request
Verifica la instalación de la GitHub App, el número de la pull request, los permisos del repositorio y si la ejecución completó antes de que el workflow terminara. Para ejecuciones activadas por comentario, el autor del comentario debe ser owner, member o collaborator del repositorio — los comentarios de bots se ignoran.
El check de GitHub está en rojo pero nada falló
Una conclusión neutral significa que el comando fue rechazado — imposible de parsear, ambiguo, por encima del límite de fan-out de 8 ejecuciones, o no autorizado. Lee el cuerpo del comentario para ver el motivo. Solo failure y timed_out reflejan un resultado de ejecución.
Autonomy eligió el entorno incorrecto desde un comentario
La precedencia del objetivo es: URL explícita, luego entorno con nombre, luego previsualización de la PR, luego coincidencia de rama, luego valor por defecto del repositorio, luego valor por defecto del espacio de trabajo, luego el objetivo por defecto del caso. Pasa url: o env: en el comentario para anular todo lo que está por debajo.
La sesión de grabación alojada nunca pasa a vivo
Una sesión alojada se ejecuta en la infraestructura de Autonomy y no puede alcanzar localhost, una IP privada ni un host solo accesible por VPN. Graba contra una URL de previsualización o de staging.
La comparación visual discrepa en cada ejecución
Comprueba el viewport primero — una referencia de escritorio comparada contra una captura móvil es una discrepancia total por definición. Luego amplía la tolerancia un nivel, o reduce la referencia de una página completa al componente bajo prueba.
La referencia de Figma no se resuelve
La URL debe incluir un node-id; copia el enlace del frame desde Figma en lugar de la URL del archivo. Si el token fue rechazado, genera un nuevo token de acceso personal y vuelve a ejecutar Test connection antes de guardar.
El aseguramiento de API reporta indeterminado
Indeterminado significa que la evidencia no pudo probar el contrato en ninguna dirección — normalmente una rama de esquema irresoluble o de profundidad limitada, o captura de red que la plataforma no pudo observar de forma fiable. Trátalo como desconocido, no como aprobado.
La ejecución móvil reporta que las pruebas móviles no están disponibles
La ejecución de iOS y Android está desactivada por defecto mientras se completa el soporte del runner de dispositivos. La subida de builds sigue funcionando; contacta con nosotros para activar la ejecución móvil en tu organización.
La aserción de red falla
Abre la evidencia de petición del paso fallido. Confirma el entorno objetivo, el estado de autenticación, el timing de la petición y si el efecto secundario del backend tiene consistencia eventual.
Artefacto móvil no encontrado
Confirma que el job de CI produjo el artefacto, que el paso de subida referencia la ruta correcta y que el artefacto coincide con la plataforma seleccionada para la ejecución.