Cómo solucionar errores en desarrollo web: 11 trucos para solucionarlos

Publicado el 3 mayo, 2024 por David Boo.  / Sin comentarios

No es raro estar programando y que aparezca un error que no nos esperamos y que nos lleve horas solucionarlo, cuando resulta que era algo sencillo como un error de sintaxis, o algo que un colega nos soluciona solo con pasar por detrás, decirte que se te ha olvidado importar una librería, o que incluso estás ejecutando algo que no es.

La capacidad de solucionar problemas viene de serie con el ser humano, por lo general somos capaces de ver que algo está roto y arreglarlo, así que en este post vamos a proveer a esta habilidad que tenemos de herramientas para ver cómo solucionar errores en desarrollo web.

Vamos a ver qué opciones tenemos cuando nos atasquemos:

Hazte la pregunta correcta

Para encontrar respuesta, una de las cosas más importantes es realizar la pregunta adecuada. Muchas veces somos incluso nosotros mismos los que tenemos la respuesta, pero nos ofuscamos y pasamos directamente a la acción a probar cambios, comprobar resultados y darte cuenta de que el error sigue ahí. Quizás así soluciones tu error, pero si no lo haces, lo mejor es parar. Para y sé un poco estratega:

¿Entiendo el problema?

Si no es así, ¿qué puedo hacer para comprenderlo mejor?

Planea una solución

Si lo comprendemos, antes de pasar a la acción deberíamos planear cómo abordarlo, estas preguntas nos ayudarán, por supuesto no hay que buscar respuesta a todas:

• ¿Tengo alguna idea inicial sobre cómo podría resolver este problema?
• ¿Qué otra información puedo obtener del error que recibo?
• ¿Cómo he resuelto un problema similar en el pasado?
• ¿Puedo pensar en una versión más simple de este problema que sea más fácil de resolver?
• ¿He considerado todas las piezas de información proporcionadas?
• ¿Qué otras formas podría utilizar para abordar este problema?

Ejecutar y comprobar

Llevamos a cabo el plan y comprobamos si de esta forma hemos resuelto el problema que teníamos al inicio. En caso de no haberlo conseguido, repetimos, es un proceso iterativo hasta dar con la solución.

Realizar la pregunta correcta también nos va a ayudar a encontrar cómo solucionar nuestro error en Google.

Aísla el código

Quítate de en medio tanto como puedas de la ecuación, si tienes demasiadas cosas funcionando al mismo tiempo e interactuando a la vez y tienes la posibilidad, aísla tu parte del código que te da problemas.

A veces tan solo retirar esa parte que da problemas hace que el resto funcione. Esto puede ser especialmente útil trabajando con componentes o funciones. Incluso esto puede funcionarnos a la hora de encontrar problemas en WordPress, desactivando plugins y reactivándolos hasta dar con el que genera el error.

Comentar el código

Sería otra manera de asilar el código, que por ejemplo puedes ser útil en CSS: imagina por un momento que te llega una aplicación o una web hecha por otra persona, con la hoja de estilos desorganizada y quieres identificar ciertos márgenes o paddings, una manera de solucionar esto, sería comentar el código utilizando la filosofía del algoritmo divide and conquer, comentamos la mitad del código y ejecutamos la otra mitad, viendo si ese margen o padding en concreto ha desaparecido, si lo ha hecho comentaremos la mitad de la parte ya comentada, y si no, comentaremos la no comentada antes, y así sucesivamente.

Suena un poco locura esta manera, pero es simplemente una idea para solucionar problemas en desarrollo web, por supuesto dependerá de las dimensiones del código, de si es modular, etc.

Replicar el error

Esto ayuda a simplificarlo y darle otro enfoque, quedarse con lo necesario e intentar reproducirlo en otras condiciones. Además, esto no es solo una manera de verlo desde otro enfoque, sino que muchas veces para compartirlo con otras personas a través de StackOverflow, foros, etc… debes simplificar el error y mandar la información justa y necesaria para que la persona entienda tu error y pueda ayudarte a comprender qué está pasando.

Leer la documentación en busca de errores

Raro es que al buscar un error en internet la documentación salga antes posicionada que la respuesta a la pregunta en un sitio como StackOverflow, no obstante, la documentación de lo que estás usando es por lo general un recurso gratuito y disponible para todos los usuarios.

Además, será la fuente más actualizada de información que puedas encontrar, donde muchas veces aparecen preguntar o errores frecuentes.

Compartir el error con la comunidad

Comparte tu error, StackOverflow, Twitter, Github Issues, Reddit, foros … hay múltiples plataformas donde puedes compartirlo para obtener respuesta. Ahora, ¿cómo compartir un error con la comunidad?

Entiende tu problema

Con este paso a lo mejor lo solucionas directamente, pero entiende bien qué te ocurre para poder preguntarlo de la forma correcta y orientar así quien tenga que ayudarte a solucionarlo.

Sé simple y claro

Da tu problema mascado a quien quieras que te ayude, utiliza negritas, espaciados correctos, listas si hacen falta, utiliza un lenguaje claro y simple y a poder ser sin faltas de ortografía.

No escribas párrafos enormes, añade capturas de pantalla y/o fragmentos de código, los errores de consola, o el log de tu servidor, cualquier detalle puede orientar a quien intente ayudarte.

Por último sé amable. Y no olvides dar las gracias a quien intente ayudarte.

Deshacer cambios

¿Cuántas veces has hecho un cambio en tu proyecto, has ido a ver el resultado y se te ha roto todo? Con demasiada frecuencia, cuando algo se rompe después de realizar un cambio en el código, tendemos a culpar automáticamente al cambio mismo. Es fácil caer en la trampa de asumir que dicha correlación implica causalidad, pero esto no es siempre así del todo.

Siempre que nos enfrentemos a un problema después de realizar un cambio en el código, una buena práctica es volver a una versión anterior del mismo y verificar si el problema persiste haciendo el cambio en dicha versión. Esto nos proporcionará una mejor comprensión de si el cambio realmente fue la causa del problema o si hay otros factores en juego.

Esto es un argumento a favor de hacer commits con frecuencia en git, así podemos mantener un registro de los cambios realizados en el código. Esto significa que si algo funciona, si hemos completado una funcionalidad o cualquier parte del código, podemos hacer un commit y volver a él en caso de necesidad. Esta práctica puede ahorrarnos tiempo y esfuerzo al solucionar problemas.

Prestar atención a los mensajes de error

Parece obvio, pero pueden surgir un montón de preguntas al prestar atención a los mensajes de error, así que si tienes uno tómate tu tiempo, léelo, obsérvalo y buscar las pistas para solucionarlo, como en qué línea nos advierte que se está rompiendo.

Entender el mensaje de error no solo te dirá qué está mal, sino también dónde está el problema. Es como una gran luz roja intermitente que te indica exactamente dónde debes dirigir tu atención. Solo con comprender el mensaje que estás leyendo y su significado, puedes estar un paso más cerca de resolver el error.

Google (u otros buscadores)

Las búsquedas en internet en cuanto a problemas tienen como resultado casos particulares, pero para nuestra sorpresa un alto porcentaje de las cosas que nos ocurre ya les ha ocurrido a alguien, así que busca a esa gente a la que ya le ha ocurrido como a ti.

Copia el mensaje de error, pégalo en el buscador, por lo general recibirás varias respuestas en los primeros resultado, de gente que ya ha compartido un error similar (si no es el mismo). Si resulta que es el mismo error, la solución puede ser la misma, o puede que no. Debes probarla, con el tiempo se acaba entendiendo si la solución que se ha encontrado va a ayudar a resolver el error que tenemos o no

Corregir errores de código con IA

Hay múltiples modelos que cuenta con un chat con inteligencia artificial, al los cuales se les puede copiar tu problema y ellos te hacen una interpretación de qué te puede estar pasando.

Para ello, debes proporcionarles, por un lado, una detallada descripción de qué te ocurre, tu mensaje de error si lo tienes y el código que creas que está involucrado. Además, cualquier información extra será bienvenida, eso sí, evita añadir información por añadir, ya que, por un lado, lo despistará y por otro suelen tener espacio limitado en el área donde se escriben estos mensajes.

En general, estos modelos te devolverán una respuesta que se aproxime, pero deberás hacer un proceso iterativo si a la primera no acierta, e ir orientándole hasta dar con la clave de tu problema. Es más, habrá veces que te convendrá reformular la pregunta que has planteado en un inicio y darle otra oportunidad

Cabe añadir, que esto no es más que otra herramienta o camino para la resolución de problemas, no descarta las demás, cada una tiene su momento y disponer de todas nos da un abanico de posibilidades.

Descansa y vuelve

Para terminar, si todavía sigues pensando cómo solucionar errores en desarrollo web, esta me parece clave. Descansa. Pone el foco en otra cosa.

Consultarlo con la almohada es un dicho muy usado para reflexionar sobre problemas o decisiones, pero en este caso sirve. Pasamos horas a veces intentando resolver un problema, y al quitar el foco de este, nuestro subconsciente sigue trabajando para resolverlo, de manera que al volver a poner el foco en el mismo, la solución aparece.

Así que si te atascas con algo y crees que no hay manera, para, vete a por un café o un vaso de agua, haz otra cosa, quizás puedes aprovechar para hacer ese día tareas que requieran menos esfuerzo mental, y al día siguiente estarás mucho más cerca de la solución.

¡Hasta otra!

En este mundo el toparse con errores es una constante del día a día, disponer de herramientas nunca nos va a venir mal para poder tirar de ellas en las diferentes situaciones en las que nos vayamos encontrando este tipo de errores.

Y si te encuentras con problemas y obstáculos en tu camino de aprendizaje, la formación en desarrollo web es un extra en tu lista de herramientas.