PostgreSQL 22003 en base de datos: valor numérico fuera de rango

Aviso: Sigue el orden documentado. Un código identifica el sistema afectado, pero por sí solo no demuestra qué pieza está averiada.

1. 1

   Dato introducido en la aplicación

   Sin herramientas especiales

   Quién:

   tú, quien usa la aplicación.

   Cómo:

   revisa la cifra que escribiste: ceros de más, separador decimal o unidades.

   Resultado que importa:

   si el número es razonable para ese campo.

   Si había un error de tecleo:

   confírmalo corrigiendo el dato; el error desaparece.

   Si la cifra es correcta:

   indica un límite de la base; avisa al soporte.

   Evidencia a conservar:

   captura del formulario y del mensaje, con hora.

   Evidencia: PostgreSQL 18 Appendix A: Error Codes

2. 2

   Columna y tipo afectados

   Sin herramientas especiales

   Quién:

   tú, como desarrollador.

   Cómo:

   lee los campos del error (Message, Detail, Where, Column si viene) y localiza la columna o la expresión.

   Resultado que importa:

   el tipo declarado y el valor que se intentó guardar.

   Si el valor supera el rango del tipo:

   confirma la causa; el diseño del tipo debe revisarse.

   Si el valor cabe en la columna:

   apunta a un cálculo intermedio; revisa la expresión.

   Evidencia a conservar:

   sentencia, valor y tipo de la columna.

   Evidencia: PostgreSQL error and notice fields · PostgreSQL 18 numeric types

3. 3

   Rango frente al dato real

   Sin herramientas especiales

   Quién:

   tú, como desarrollador.

   Cómo:

   compara el valor con el rango de la tabla de tipos enteros o con la precisión y escala de numeric.

   Resultado que importa:

   cuánto margen falta.

   Si es un entero que se acerca al máximo de integer:

   indica que bigint es la alternativa documentada.

   Si es numeric:

   indica que la precisión declarada no basta para ese dato.

   Evidencia a conservar:

   rango del tipo y valor máximo observado.

   Evidencia: PostgreSQL 18 numeric types

Un código solo tiene significado dentro del producto y la versión correctos.

El apéndice A asigna 22003 a numeric_value_out_of_range, en la clase 22 Data Exception. Según la documentación de tipos numéricos, guardar un valor fuera del rango permitido produce un error: smallint admite de -32768 a +32767, integer de -2147483648 a +2147483647 y bigint su propio rango; en numeric(precisión, escala) falla si sobran dígitos a la izquierda de la coma; en real y double precision los valores demasiado grandes o pequeños dan error. El código señala el valor y el tipo, no un fallo del servidor.

• Precauciónadvertencia editorial

  No recortes ni redondees el dato en la aplicación solo para que entre: guardarías un valor distinto del real sin aviso. Si la cifra es correcta, detente y avisa al soporte.

  Evidencia: PostgreSQL 18 numeric types

1. 1

   PostgreSQL 18 Appendix A: Error Codes

   PostgreSQL Global Development Group · 2026 · official_doc

2. 2

   PostgreSQL error and notice fields

   PostgreSQL Global Development Group · 2026 · official_doc