Resolver

ValueError en Python: qué significa y cómo resolverlo

El error que aparece cuando un valor tiene el tipo correcto pero no el contenido esperado, como convertir texto no numérico a int. Causas típicas y cómo evitarlo.

Python te detiene con algo como esto:

ValueError: invalid literal for int() with base 10: 'abc'

El ValueError significa algo preciso: le pasaste a una función un valor del tipo correcto pero con un contenido que no puede manejar. Le diste texto a int(), pero ese texto no representa un número. Es distinto del TypeError (tipo equivocado); aquí el tipo está bien, el valor no. Vamos a las causas.

Causa 1: convertir texto no numérico a número

La más común, sobre todo al leer datos de usuarios o archivos:

int("42")      # 42 — bien
int("abc")     # ValueError: no es un número
int("3.14")    # ValueError: int() no acepta decimales en texto
int("")        # ValueError: cadena vacía

Fíjate en el tercer caso: int("3.14") falla porque int() no convierte un decimal escrito como texto. Si el texto trae decimales, primero float y luego int:

int(float("3.14"))   # 3

El arreglo general es validar o atrapar antes de convertir:

texto = input("Edad: ")
try:
    edad = int(texto)
except ValueError:
    print("Eso no es un número válido")

Con datos que vienen de fuera (formularios, archivos, input), nunca asumas que son convertibles. Atrapa el ValueError.

Causa 2: desempaquetar un número equivocado de valores

coordenadas = "10,20,30"
x, y = coordenadas.split(",")   # ValueError: too many values to unpack

Esperabas dos partes pero split devolvió tres, y Python no sabe qué hacer con la extra. El mensaje “too many values to unpack” (o “not enough values”) es un ValueError. El arreglo es asegurar que las partes coincidan:

partes = coordenadas.split(",")
if len(partes) == 2:
    x, y = partes
else:
    print(f"Esperaba 2 valores, llegaron {len(partes)}")

Causa 3: convertir fechas con formato que no coincide

Al parsear fechas con strptime, si el formato no cuadra con el texto, salta ValueError:

from datetime import datetime

datetime.strptime("2026-11-11", "%d/%m/%Y")   # ValueError: formato no coincide

El texto viene con guiones (2026-11-11) pero el patrón espera barras (%d/%m/%Y). El patrón debe reflejar exactamente los separadores del texto. Lo ves en detalle en el artículo de fechas y horas con datetime.

Causa 4: operaciones de matemáticas o librerías

Algunas funciones lanzan ValueError ante valores fuera de su dominio:

import math
math.sqrt(-1)    # ValueError: no hay raíz cuadrada real de un negativo

El tipo (número) es correcto, pero el valor (-1) está fuera de lo que la función acepta. El arreglo es validar el rango antes:

if numero >= 0:
    raiz = math.sqrt(numero)
else:
    print("No se puede sacar raíz de un negativo")

El diagnóstico

Cuando aparezca ValueError:

  1. ¿Conviertes texto a número? Valida o atrapa con try/except ValueError; recuerda que int() no acepta decimales en texto ni cadenas vacías.
  2. ¿Desempaquetas con =? Comprueba que el número de partes coincida (len(partes)).
  3. ¿Parseas fechas? El formato de strptime debe cuadrar exacto con el texto.
  4. ¿Usas una función matemática? Valida que el valor esté en el rango que acepta.

La clave para no confundirlo: ValueError es “el tipo está bien, pero este valor concreto no sirve”. Casi siempre aparece con datos que vienen de fuera, así que la regla de oro es validarlos antes de usarlos.


¿Te sale al procesar un archivo con datos mezclados donde unas filas convierten bien y otras no? Escríbeme desde contacto y lo vemos.

← Más de Resolver