AttributeError: 'NoneType' object has no attribute en Python
El error que aparece cuando llamas un método sobre algo que resultó ser None. Qué significa, por qué tu variable es None, y cómo evitar que el código se rompa.
Python te corta con algo como esto:
AttributeError: 'NoneType' object has no attribute 'strip'
(o .append, .text, .get, el que sea). El mensaje dice algo preciso: intentaste usar un método o atributo sobre un valor que es None, y None no tiene ese método. La pregunta real no es “por qué falla el método”, sino “¿por qué esta variable es None cuando yo esperaba un objeto?”. Vamos a las causas.
Qué significa exactamente
nombre = None
nombre.strip() # AttributeError: 'NoneType' object has no attribute 'strip'
None es el “nada” de Python. No es texto, ni lista, ni objeto, así que no tiene métodos como .strip() o .append(). Cuando ves este error, algo que esperabas que fuera un objeto llegó como None. Hay que encontrar ese “algo”.
Causa 1: una función que no devuelve (olvidó el return)
La más común. Usas el resultado de una función que no tiene return, así que devuelve None:
def obtener_usuario(id):
usuario = buscar_en_db(id)
# ¡falta el return!
u = obtener_usuario(5)
print(u.nombre) # AttributeError: 'NoneType' has no attribute 'nombre'
La función hace su trabajo pero no devuelve nada, entonces u es None. El arreglo es obvio al verlo: agregar el return usuario.
Causa 2: un método que modifica en el sitio y devuelve None
Varios métodos de Python cambian el objeto pero devuelven None, no el objeto. El clásico es sort():
lista = [3, 1, 2]
ordenada = lista.sort() # sort() devuelve None
ordenada.append(4) # AttributeError: 'NoneType' has no attribute 'append'
sort(), append(), reverse() y similares devuelven None por diseño. El arreglo: usa el objeto original, no el resultado del método.
lista.sort() # ordena lista directamente
lista.append(4) # trabaja sobre lista, no sobre el resultado de sort()
Causa 3: una búsqueda que no encontró nada
Muy frecuente con bases de datos, scraping o diccionarios. Cuando no hay resultado, muchas funciones devuelven None:
from bs4 import BeautifulSoup
# ...
titulo = sopa.find("h1") # None si no hay <h1>
texto = titulo.text # AttributeError si titulo es None
Lo mismo con un fetchone() de base de datos sin resultados, o un .get() de diccionario sobre una clave ausente. El arreglo es comprobar antes de usar:
titulo = sopa.find("h1")
if titulo is not None:
texto = titulo.text
else:
texto = "sin título"
Causa 4: encadenar llamadas donde una devuelve None
Cuando encadenas métodos, basta que uno en medio devuelva None para que el siguiente falle:
valor = datos.get("config").get("tema") # falla si "config" no existe
Si "config" no está, el primer .get() devuelve None, y el segundo .get() revienta. El arreglo es dar un respaldo en cada eslabón:
valor = datos.get("config", {}).get("tema", "claro")
Cada .get("clave", {}) devuelve un diccionario vacío si falta, de modo que el siguiente no falla.
El diagnóstico
Cuando aparezca AttributeError: 'NoneType'..., no mires el método — mira de dónde salió la variable:
- ¿Viene de una función tuya? Revisa que tenga
return. - ¿Viene de
sort(),append(),reverse()? Esos devuelvenNone; usa el objeto original. - ¿Viene de una búsqueda (find, fetchone, get)? Comprueba
if x is not Noneantes de usarla. - ¿Encadenaste llamadas? Da un respaldo en cada eslabón.
La idea de fondo es la misma que con otros errores de None: algo te dio None cuando esperabas un objeto. Encuentra ese “algo” y el resto es directo. Si el error fuera 'NoneType' object is not subscriptable (con corchetes en vez de punto), es el mismo origen visto desde otro acceso.
¿Te sale encadenando métodos de una librería y no ves cuál devuelve None? Escríbeme desde contacto con el fragmento y lo revisamos.