How to fix ERR value is not an integer or out of range in Redis

# Connect to Redis CLI:
redis-cli

# Check the value type and content:
TYPE mykey
GET mykey

# For hash fields:
HGET myhash field
TYPE myhash

# For sorted sets:
ZSCORE myzset member

# Set to a valid integer:
SET mykey 0

# Then increment:
INCR mykey
# Returns: (integer) 1

# For hashes:
HSET myhash field 0
HINCRBY myhash field 5
# Returns: (integer) 5

# Store a decimal:
SET price 3.14

# INCR fails:
INCR price
# Error: ERR value is not an integer or out of range

# Use INCRBYFLOAT instead:
INCRBYFLOAT price 0.5
# Returns: "3.64"

# INCRBYFLOAT works with both integers and floats:
INCRBYFLOAT price 2
# Returns: "5.64"

# Check the current value:
GET mycounter

# If approaching 9223372036854775807, you are at the limit:
# Maximum 64-bit signed int: 9223372036854775807
# Minimum 64-bit signed int: -9223372036854775808

# If overflow is a concern, reset the counter:
DEL mycounter
SET mycounter 0

# Or use a different key naming strategy with timestamp:
SET counter:2025:12:25 0

# Correct format (db index is 0, 1, 2, etc.):
redis://localhost:6379/0
redis://localhost:6379/1

# Incorrect format (non-numeric db name):
redis://localhost:6379/robotix_max_bot  # Wrong!

# Fix by either:
# 1. Remove the invalid db name:
redis://localhost:6379
# This defaults to db 0

# 2. Or explicitly pass db parameter:
redis://localhost:6379?db=0

// Node.js example:
const redis = require("redis");
const client = redis.createClient();

// Before setting a counter:
function setCounter(key, value) {
  if (!Number.isInteger(value)) {
    throw new Error("Counter must be an integer");
  }
  if (value < -9223372036854775808 || value > 9223372036854775807) {
    throw new Error("Value exceeds 64-bit signed integer limits");
  }
  return client.set(key, value.toString());
}

// Safe increment:
async function safeIncrement(key) {
  const value = await client.get(key);
  if (value === null) {
    return client.set(key, "1");
  }
  if (!/^-?\d+$/.test(value)) {
    throw new Error(`Invalid integer in key ${key}: ${value}`);
  }
  return client.incr(key);
}

-- Problematic pattern in Redis 7.2+ when ARGV[1] matches n * 100,000,000:
local increment = tonumber(ARGV[1])  -- May fail for certain numeric patterns
redis.call('HINCRBY', KEYS[1], KEYS[2], increment)

-- Safer approach: validate and handle the conversion explicitly:
local increment = ARGV[1]
if type(increment) == "string" then
  increment = tonumber(increment)
end

if increment == nil or (increment % 1 ~= 0) then
  error("INVALIDARG Increment must be an integer")
end

return redis.call('HINCRBY', KEYS[1], KEYS[2], increment)