Este documento recopila errores comunes y comportamientos sutiles en Java que pueden generar bugs dif\u00edciles de detectar. Cada entrada sigue el esquema problema \u2192 soluci\u00f3n \u2192 discusi\u00f3n<\/strong> para que puedas identificar, entender y evitar estos fallos en tu c\u00f3digo.<\/p>\n\n\n\n Problema:<\/strong> El operador Soluci\u00f3n:<\/strong> Usa Discusi\u00f3n:<\/strong> Java cachea los Problema:<\/strong> Soluci\u00f3n:<\/strong> Compara cadenas con Discusi\u00f3n:<\/strong> El string pool<\/em> puede hacer que dos literales apunten a la misma referencia, pero objetos creados con Problema:<\/strong> Eliminar o a\u00f1adir elementos a una colecci\u00f3n mientras se recorre con Soluci\u00f3n:<\/strong> Usa un Discusi\u00f3n:<\/strong> Muchas colecciones detectan cambios estructurales durante la iteraci\u00f3n. Las colecciones concurrentes (p. ej., Problema:<\/strong> Convertir un Soluci\u00f3n:<\/strong> Valida Discusi\u00f3n:<\/strong> El unboxing invoca internamente Problema:<\/strong> Asignar un array a otra variable copia la referencia; cambios en una vista afectan a la otra.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Usa Discusi\u00f3n:<\/strong> La copia por referencia es r\u00e1pida pero sorprende a quienes esperan independencia de datos. Para estructuras anidadas, copia cada nivel.<\/p>\n\n\n\n Problema:<\/strong> Olvidar Soluci\u00f3n:<\/strong> A\u00f1ade Discusi\u00f3n:<\/strong> El fall-through<\/em> es \u00fatil en casos agrupados, pero suele ser fuente de bugs. Las expresiones Problema:<\/strong> Llamar a m\u00e9todos sobreescritos desde un constructor puede usar campos a\u00fan no inicializados de la subclase.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> No invoques m\u00e9todos sobreescritos en constructores; usa m\u00e9todos Discusi\u00f3n:<\/strong> El constructor de la superclase se ejecuta antes de inicializar los campos de la subclase. La llamada virtual accede a estado incompleto.<\/p>\n\n\n\n Problema:<\/strong> No se pueden crear arrays de tipos gen\u00e9ricos concretos, p. ej., Soluci\u00f3n:<\/strong> Usa Discusi\u00f3n:<\/strong> Los arrays son covariantes y reificados; los gen\u00e9ricos usan borrado de tipos. La mezcla rompe seguridad de tipos en tiempo de ejecuci\u00f3n.<\/p>\n\n\n\n Problema:<\/strong> Modificar una clave despu\u00e9s de insertarla impide encontrarla de nuevo.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Usa claves inmutables (por ejemplo, Discusi\u00f3n:<\/strong> Problema:<\/strong> Llamar a Soluci\u00f3n:<\/strong> Usa Discusi\u00f3n:<\/strong> Problema:<\/strong> El par\u00e1metro del m\u00e9todo oculta el campo de instancia y asignaciones como Soluci\u00f3n:<\/strong> Usa Discusi\u00f3n:<\/strong> El sombreado dificulta el mantenimiento y causa bugs silenciosos. Activar inspecciones del IDE ayuda a detectarlo.<\/p>\n\n\n\n Problema:<\/strong> Un hilo no observa cambios de otro hilo sobre una variable sin sincronizaci\u00f3n.<\/p>\n\n\n\n Soluci\u00f3n:<\/strong> Declara la variable como Discusi\u00f3n:<\/strong> El modelo de memoria de Java permite reordenamientos y cach\u00e9s por hilo. Problema:<\/strong> Operaciones como Soluci\u00f3n:<\/strong> Usa Discusi\u00f3n:<\/strong> Problema:<\/strong> Soluci\u00f3n:<\/strong> Usa constantes ( Discusi\u00f3n:<\/strong> La API antigua de fechas es propensa a errores. Problema:<\/strong> Soluci\u00f3n:<\/strong> Define un formateador: Discusi\u00f3n:<\/strong> Por defecto, <\/p>\n","protected":false},"excerpt":{"rendered":" This document compiles common errors and subtle behaviors in Java that can lead to difficult-to-detect bugs. <\/p>","protected":false},"author":1,"featured_media":264,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","footnotes":""},"categories":[5,4],"tags":[],"class_list":["post-263","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-buenas-practicas","category-desarrollo"],"_links":{"self":[{"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/posts\/263","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/comments?post=263"}],"version-history":[{"count":1,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/posts\/263\/revisions"}],"predecessor-version":[{"id":265,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/posts\/263\/revisions\/265"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/media\/264"}],"wp:attachment":[{"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/media?parent=263"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/categories?post=263"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/carlosarranz.es\/en\/wp-json\/wp\/v2\/tags?post=263"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
\n\n\n\n1. Comparaci\u00f3n de Integer fuera del rango cacheado<\/h3>\n\n\n\n
==<\/code> devuelve false<\/code> para enteros mayores a 127 (o menores a -128) aunque los valores num\u00e9ricos sean iguales.<\/p>\n\n\n\n.equals()<\/code> para comparar valores de Integer<\/code>. Para rendimiento o simplicidad, usa int<\/code> si no necesitas nulos.<\/p>\n\n\n\nInteger<\/code> en el rango [-128, 127]. Fuera de ese rango, Integer.valueOf()<\/code> devuelve instancias distintas; ==<\/code> compara referencias, no contenido.<\/p>\n\n\n\n
\n\n\n\n2. Comparaci\u00f3n de String con ==<\/h3>\n\n\n\n
==<\/code> entre cadenas a veces da true<\/code> y otras false<\/code> para el mismo texto, lo que confunde a principiantes.<\/p>\n\n\n\n.equals()<\/code> o .equalsIgnoreCase()<\/code>.<\/p>\n\n\n\nnew String()<\/code> no. ==<\/code> compara referencias; .equals()<\/code> compara contenido.<\/p>\n\n\n\n
\n\n\n\n3. Modificar una colecci\u00f3n durante la iteraci\u00f3n<\/h3>\n\n\n\n
for-each<\/code> lanza ConcurrentModificationException<\/code>.<\/p>\n\n\n\nIterator<\/code> y su remove()<\/code>, o recopila primero y modifica despu\u00e9s; alternativamente, usa colecciones concurrentes.<\/p>\n\n\n\nCopyOnWriteArrayList<\/code>) tienen sem\u00e1nticas diferentes y coste adicional.<\/p>\n\n\n\n
\n\n\n\n4. NullPointerException al hacer unboxing<\/h3>\n\n\n\n
Integer<\/code> null<\/code> a int<\/code> produce NullPointerException<\/code>.<\/p>\n\n\n\nnull<\/code> antes del unboxing o usa OptionalInt<\/code> \/ valores por defecto.<\/p>\n\n\n\nintValue()<\/code> sobre la referencia; si es null<\/code>, falla. Ev\u00edtalo donde sea posible usando tipos primitivos.<\/p>\n\n\n\n
\n\n\n\n5. Arrays no hacen copia profunda<\/h3>\n\n\n\n
Arrays.copyOf()<\/code> o clone()<\/code> para copiar el array; para matrices\/objetos, implementa una copia profunda expl\u00edcita.<\/p>\n\n\n\n
\n\n\n\n6. Falta de break en switch (fall-through)<\/h3>\n\n\n\n
break<\/code> ejecuta casos adicionales inesperadamente.<\/p>\n\n\n\nbreak<\/code> o usa switch<\/code> con expresiones (Java 14+) y -><\/code>, que no hace fall-through<\/em> por defecto.<\/p>\n\n\n\nswitch<\/code> modernas reducen este riesgo.<\/p>\n\n\n\n
\n\n\n\n7. Llamadas virtuales en constructores (inicializaci\u00f3n incompleta)<\/h3>\n\n\n\n
final<\/code> o inicializaci\u00f3n expl\u00edcita.<\/p>\n\n\n\n
\n\n\n\n8. Arrays de tipos gen\u00e9ricos<\/h3>\n\n\n\n
new ArrayList<String>[10]<\/code>.<\/p>\n\n\n\nList<?>[]<\/code> o preferentemente colecciones, evitando arrays de gen\u00e9ricos.<\/p>\n\n\n\n
\n\n\n\n9. Claves mutables en HashMap\/HashSet<\/h3>\n\n\n\n
record<\/code> o clases inmutables) o no modifiques las claves tras usarlas.<\/p>\n\n\n\nhashCode()<\/code> y equals()<\/code> determinan la ubicaci\u00f3n. Si cambian, el mapa pierde la referencia a la entrada.<\/p>\n\n\n\n
\n\n\n\n10. Optional.get() sin verificar presencia<\/h3>\n\n\n\n
get()<\/code> sobre un Optional<\/code> vac\u00edo lanza NoSuchElementException<\/code>.<\/p>\n\n\n\norElse()<\/code>, orElseGet()<\/code>, orElseThrow()<\/code> o ifPresent()<\/code>.<\/p>\n\n\n\nOptional<\/code> pretende evitar null<\/code>; usar get()<\/code> rompe su intenci\u00f3n. Prefiere API expresivas.<\/p>\n\n\n\n
\n\n\n\n11. Shadowing de variables (ocultamiento de campos)<\/h3>\n\n\n\n
nombre = nombre;<\/code> no hacen nada \u00fatil.<\/p>\n\n\n\nthis.nombre = nombre;<\/code> o cambia el nombre del par\u00e1metro.<\/p>\n\n\n\n
\n\n\n\n12. Concurrencia: falta de
volatile<\/code> (visibilidad)<\/h3>\n\n\n\nvolatile<\/code> o sincroniza accesos (synchronized<\/code>, Lock<\/code>).<\/p>\n\n\n\nvolatile<\/code> garantiza visibilidad y orden de publicaci\u00f3n\/lectura.<\/p>\n\n\n\n
\n\n\n\n13. Concurrencia: incrementos no at\u00f3micos<\/h3>\n\n\n\n
valor++<\/code> pierden actualizaciones bajo concurrencia.<\/p>\n\n\n\nAtomicInteger.incrementAndGet()<\/code>, bloques synchronized<\/code> o acumuladores (LongAdder<\/code>).<\/p>\n\n\n\nvalor++<\/code> implica leer-modificar-escribir. Sin exclusi\u00f3n mutua, dos hilos pueden sobrescribir resultados.<\/p>\n\n\n\n
\n\n\n\n14. Calendar: mes base cero<\/h3>\n\n\n\n
Calendar#set(a\u00f1o, mes, d\u00eda)<\/code> interpreta enero como 0; 10<\/code> es noviembre, no octubre.<\/p>\n\n\n\nCalendar.OCTOBER<\/code>) o migra a java.time<\/code>.<\/p>\n\n\n\njava.time<\/code> (JSR-310) es m\u00e1s clara e inmutable.<\/p>\n\n\n\n
\n\n\n\n15. LocalDate.parse() con formatos no ISO<\/h3>\n\n\n\n
LocalDate.parse("05\/10\/2025")<\/code> lanza DateTimeParseException<\/code>.<\/p>\n\n\n\nDateTimeFormatter.ofPattern("dd\/MM\/yyyy")<\/code> y p\u00e1salo a parse()<\/code>.<\/p>\n\n\n\nparse()<\/code> espera yyyy-MM-dd<\/code>. Para otros formatos debes indicar el patr\u00f3n expl\u00edcitamente.<\/p>\n\n\n\n