{
  "schema_version": 2,
  "id": "develop/reference/errors",
  "title": "Redis error messages",
  "url": "https://redis.io/docs/latest/develop/reference/errors/",
  "summary": "What common Redis error messages mean and how to fix them",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-11-02T15:10:28+01:00",
  "children": [
    {
      "id": "develop/reference/errors/common",
      "summary": "The Redis errors you're most likely to see, with an example and how to fix each one",
      "title": "Common Redis errors",
      "url": "https://redis.io/docs/latest/develop/reference/errors/common/"
    },
    {
      "id": "develop/reference/errors/all",
      "summary": "Every error message that Redis 8.10 and its built-in features can return, with the commands that return it",
      "title": "All Redis error messages",
      "url": "https://redis.io/docs/latest/develop/reference/errors/all/"
    }
  ],
  "page_type": "content",
  "content_hash": "3a19d6b0e6f869ce23da8e70c75906fa804def1cd50d5b4bb41d3b01022f02fa",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "When a command fails, Redis replies with an error message instead of a result. This section explains the [most common errors](https://redis.io/docs/latest/develop/reference/errors/common), and lists [every error message](https://redis.io/docs/latest/develop/reference/errors/all) that Redis 8.10 can return.\n\nTo find an error, paste it in the box. You can paste the whole line from your terminal or logs, including the exception name that your client library adds. The box searches both the common errors and the list of all error messages."
    },
    {
      "id": "how-redis-reports-errors",
      "title": "How Redis reports errors",
      "role": "content",
      "text": "Error messages from the Redis server start with an uppercase word, called the error prefix. A description follows the prefix:\n\n[code example]\n\nThe prefix tells you the kind of error, so your code can check it without reading the description. `ERR` is the general-purpose prefix. When an error starts with `ERR`, the description tells you what went wrong.\n\nErrors from Redis Search, JSON, and the other features that come with Redis don't always follow this rule. Most Redis Search errors start with a code such as `SEARCH_INDEX_NOT_FOUND`. Some JSON, probabilistic data type, and time series errors have no prefix at all, such as `Bad capacity`. Client libraries then treat the first word of the message as the prefix.\n\nHow you see the error depends on your tool:\n\n- `redis-cli` shows `(error)` in front of the message.\n- Client libraries raise an exception, or return an error value, that contains the message. Some libraries turn common prefixes into their own exception classes and drop the prefix from the message. For example, redis-py reports \"`READONLY You can't write against a read only replica.`\" as \"`ReadOnlyError: You can't write against a read only replica.`\".\n\nTo learn how to handle errors in your app, see [Error handling](https://redis.io/docs/latest/develop/clients/error-handling). To learn how errors are sent over the network, see [Simple errors](https://redis.io/docs/latest/develop/reference/protocol-spec#simple-errors) in the Redis serialization protocol (RESP) specification."
    },
    {
      "id": "common-errors",
      "title": "Common errors",
      "role": "content",
      "text": "[Common errors](https://redis.io/docs/latest/develop/reference/errors/common) explains the errors you're most likely to see, such as [`WRONGTYPE`](https://redis.io/docs/latest/develop/reference/errors/common/wrongtype), [`MOVED`](https://redis.io/docs/latest/develop/reference/errors/common/moved), and [`NOAUTH`](https://redis.io/docs/latest/develop/reference/errors/common/noauth). Each page shows what the error means, an example, and how to fix it."
    },
    {
      "id": "all-error-messages",
      "title": "All error messages",
      "role": "content",
      "text": "The [list of all error messages](https://redis.io/docs/latest/develop/reference/errors/all) shows every error that Redis 8.10 can return, and the commands that return it. It has a page for each part of Redis:\n\n- [Redis server](https://redis.io/docs/latest/develop/reference/errors/all/redis)\n- [Vector sets](https://redis.io/docs/latest/develop/reference/errors/all/vector-sets)\n- [Redis Search](https://redis.io/docs/latest/develop/reference/errors/all/search)\n- [JSON](https://redis.io/docs/latest/develop/reference/errors/all/json)\n- [Probabilistic data types](https://redis.io/docs/latest/develop/reference/errors/all/probabilistic)\n- [Time series](https://redis.io/docs/latest/develop/reference/errors/all/time-series)"
    }
  ],
  "examples": [
    {
      "id": "how-redis-reports-errors-ex0",
      "language": "plaintext",
      "code": "WRONGTYPE Operation against a key holding the wrong kind of value",
      "section_id": "how-redis-reports-errors"
    }
  ]
}