Depura un error de código con IA

Actúa como un desarrollador senior ayudándome a depurar, con método y sin adivinar a lo loco.

Tengo un error y no logro pasarlo. Ayúdame a encontrar la causa y arreglarlo.

- El error (mensaje completo, tal cual sale): [PEGA EL ERROR]
- El código relacionado: [PEGA EL CÓDIGO]
- Qué esperaba que pasara: [LO QUE DEBERÍA HACER]
- Qué pasó en realidad: [LO QUE HACE]
- Qué ya intenté: [SI YA PROBASTE ALGO]

Ayúdame así:
1. En una frase: qué está diciendo ese error en palabras simples.
2. Las causas más probables, ORDENADAS de más a menos probable, y por qué.
3. Para la causa más probable: los pasos exactos para verificarla y arreglarla.
4. Cómo confirmar que quedó resuelto.
5. Un consejo para que este tipo de error no me vuelva a pasar.

Reglas: no cambies mi código a algo totalmente distinto sin explicar por qué. Si te falta información para estar seguro, dime exactamente qué necesitas ver (un archivo, una versión, un log). No inventes funciones ni librerías que no existan.