Diagnosticar y corregir errores de aplicaciones
Publicado el · Actualizado el
Para resolver errores de aplicaciones, describe lo ocurrido, lo esperado y los pasos que permiten repetir el problema. Examina los datos relacionados, prueba una explicación cada vez y verifica el comportamiento después de la corrección.
Documenta un problema reproducible
Indica tarea, pantalla, pasos en orden y resultados real y esperado. «La aplicación no funciona» no identifica dónde falla. «Enviar el formulario de servicio completo muestra éxito, pero la solicitud no aparece en la lista de seguimiento» ofrece un punto de partida práctico. Guarda el texto del mensaje, la hora y la zona horaria. Añade una referencia disponible de la solicitud para distinguir intentos parecidos sin adivinar a qué operación pertenece una captura o un registro determinado.
Registra condiciones que pueden cambiar el resultado: dispositivo, navegador, rol de la cuenta, versión o entorno y datos introducidos. Separa observaciones de explicaciones. Que un problema aparezca después de un cambio reciente no demuestra por sí solo que ese cambio lo haya causado. Marca como desconocidos los detalles que no conoces. Así puedes comparar intentos sin atribuir diferencias a factores no comprobados. Conserva suficiente información para que otra persona repita el caso sin reconstruir todo el historial del proyecto.
Repite el caso con datos de ejemplo en un entorno apropiado. Empieza por el caso que falla y después prueba uno normal cercano. No repitas una acción que crea solicitudes reales o envía mensajes antes de revisar el primer intento. Para errores intermitentes, registra también los intentos satisfactorios. Las diferencias entre éxito y fallo pueden resultar más útiles que una captura, especialmente cuando cambian datos, cuentas u orden de pasos. Anota la secuencia exacta en lugar de resumirla posteriormente de memoria.
- Describe realidad, expectativa y pasos.
- Guarda hora, entorno y referencia.
- Compara fallo y éxito cercanos.
Localiza dónde se interrumpe el proceso
Divide el recorrido en entrada, operación, resultado y visualización. Para una solicitud de servicio, revisa campos, intento de guardado, registro y lista. La ausencia puede deberse a visualización o filtros, pero también a que el registro nunca se creó. Distingue esas posibilidades antes de corregir. Si existe, compara estado, cuenta asociada y filtro activo. Si no existe, investiga lo ocurrido al crearlo en vez de ajustar únicamente la lista y ocultar el problema en otra parte del recorrido.
Lee mensajes y registros disponibles para identificar hasta qué etapa llegó la operación. Busca un intento con la misma hora o referencia; no combines mensajes de diferentes sesiones como un único evento. El usuario puede ver un aviso general mientras el equipo dispone de detalles, así que conserva ambos cuando sea posible. Retira claves, tokens e información de clientes innecesaria antes de compartir diagnósticos. Usa ejemplos que mantengan la estructura relevante sin exponer valores originales ni borrar la característica que desencadenó el fallo.
Prueba acceso, conexiones y datos como explicaciones separadas. Si una cuenta ve la lista y otra no, compara roles y registros esperados antes de cambiar ajustes. Cuando participe una conexión externa, revisa configuración, entorno, petición y respuesta disponible. Una pantalla simulada no demuestra una conexión real. Define qué evidencia confirmaría o descartaría cada explicación. La investigación se convierte en comprobaciones pequeñas, en lugar de varias modificaciones simultáneas cuyos efectos el equipo no puede distinguir con suficiente claridad.
- Separa entrada, guardado y visualización.
- Relaciona evidencias con el mismo intento.
- Prueba una explicación cada vez.
Solicita una corrección concreta y revisable
Prepara un resumen con pasos, comportamiento esperado, evidencias y parte realmente afectada. Si utilizas Infera Agent, aporta esos datos y pide describir el cambio y su comprobación, verificando las opciones disponibles del proyecto. Un problema en un campo no exige una petición general de reconstrucción. Cuando desconozcas la causa, solicita identificarla mediante evidencias antes de convertir una suposición en una instrucción de implementación que pueda esconder el fallo o trasladarlo a otra pantalla.
Empieza con un cambio dirigido a la causa identificada y conserva una versión recuperable mediante las herramientas del proyecto. Si una solicitud guardada queda excluida de la lista, revisa la condición de visualización en vez de crear otra automáticamente. Si falla el guardado, cambiar el mensaje de éxito no repara los datos. Describe efectos sobre comportamiento e información. Identifica tareas separadas, como revisar solicitudes antiguas afectadas, sin asumir que una versión nueva corrige automáticamente los registros históricos producidos antes del arreglo.
Revisa el cambio antes de declarar finalizado el trabajo. Comprueba que no añade acciones innecesarias y conserva información necesaria. Explica brevemente causa, modificación y puntos pendientes. Si las evidencias son insuficientes, indica la siguiente pregunta que debe responderse. Un informe de herramienta o la desaparición de un aviso no demuestra resolución completa. El recorrido definido debe funcionar correctamente y producir un resultado inspeccionable. Limita la conclusión a lo que realmente establecen las comprobaciones disponibles y documenta las condiciones en que se realizaron.
- Aporta pasos, evidencias y criterios.
- Corrige el comportamiento afectado.
- Documenta cambios y preguntas abiertas.
Comprueba la corrección y los casos cercanos
Repite los pasos originales con el mismo caso cuando sea posible. Después prueba un caso normal y un valor ausente, largo o no disponible según el problema. En el ejemplo de servicio, revisa registro, lista y estado, además del mensaje de envío. Comprueba que se conserva la entrada tras corregirla y que el fallo ofrece un siguiente paso claro. Usa cuentas y roles adecuados para no convertir el éxito de una cuenta en una conclusión injustificada sobre todos los usuarios.
Prueba recorridos cercanos que puedan verse afectados: actualizar, buscar o abrir desde otra pantalla. Revisa solicitudes anteriores como tarea separada; una corrección futura no arregla el pasado automáticamente. Examina registros incompletos o duplicados antes de procesarlos. No los borres solo porque parezcan extraños. Conserva evidencia de su estado, la decisión tomada y el resultado comprobable después. El equipo podrá distinguir así la corrección del comportamiento de la reparación de información ya producida, y valorar cada trabajo por separado.
Cierra el seguimiento con resultados de pruebas, versión comprobada y límites restantes. Identifica quién revisará el caso si vuelve a aparecer y qué información debe recopilarse entonces. Conserva ejemplos de fallo y éxito como referencia para cambios posteriores. Si un error intermitente sigue sin aclararse, dilo en lugar de anunciar una solución completa. Un registro útil relaciona decisiones con resultados revisables y evita empezar la siguiente investigación con suposiciones sin fundamento o con descripciones que ya no corresponden a la versión actual.
- Repite casos originales y cercanos.
- Revisa datos anteriores por separado.
- Documenta resultados y límites.
Preguntas
¿Qué información recopilo primero?
Pasos y comportamiento real frente al esperado. Añade hora, entorno y referencia disponible, y empieza por un caso que pueda revisarse.
¿Basta un mensaje de éxito?
No. Examina el resultado real, como el registro guardado y su visibilidad para el usuario correcto. El mensaje no sustituye esa comprobación.
¿Cómo investigo un error intermitente?
Registra intentos satisfactorios y fallidos y compara datos, cuentas, entornos y pasos. Un intento sin fallo no demuestra resolución.
¿Cuándo está completa la corrección?
Tras repetir el caso original y revisar recorridos afectados, documentando versión, límites pendientes y tratamiento separado de los datos anteriores.