Redis按模式删除键报错：执行redis-cli命令提示del参数数量错误

看起来你遇到的这个错误，大概率是两种常见情况导致的，我来一步步帮你排查和解决：

情况1：没有匹配到任何键，导致DEL命令无参数执行 #

当redis-cli --raw keys "$xx"没有返回任何结果时，xargs会直接运行redis-cli del，而DEL命令至少需要一个键名作为参数，这就触发了ERR wrong number of arguments错误。

解决办法： #

使用xargs的-r选项（GNU xargs默认支持，macOS用户如果用系统自带xargs可以换成gxargs，或者安装GNU版本），这个选项的作用是当没有输入时不执行后续命令：

redis-cli --raw keys "$xx" | xargs -r redis-cli del

如果是macOS且不想折腾GNU工具，可以用条件判断先检查是否有结果：

matched_keys=$(redis-cli --raw keys "$xx")
if [ -n "$matched_keys" ]; then
  echo "$matched_keys" | xargs redis-cli del
fi

情况2：键名包含空格/特殊字符，导致参数拆分错误 #

如果你的键名里有空格、换行或者其他特殊字符，xargs默认会按空格/制表符/换行拆分输入，这会把一个完整的键拆成多个参数传给DEL，导致命令收到错误数量的参数。

解决办法： #

指定xargs用换行符作为分隔符，确保每个键作为单独的参数传递：

redis-cli --raw keys "$xx" | xargs -r -d '\n' redis-cli del

-d '\n'告诉xargs只按换行拆分输入，完美保留键名里的特殊字符。

生产环境注意事项 #

最后提醒一下：KEYS命令在生产环境要谨慎使用！它会遍历Redis所有键，数据量大时会阻塞Redis服务，影响性能。推荐用非阻塞的SCAN命令替代，比如：

redis-cli --raw scan 0 MATCH "$xx" COUNT 1000 | xargs -r -d '\n' redis-cli del

SCAN会分批返回匹配的键，不会长时间阻塞Redis，更适合生产环境。

内容的提问来源于stack exchange，提问作者P.K.Hindustani