加--raw可解决redis-cli中文乱码，ThinkPHP乱码主因是写入前未统一UTF-8编码或读取后误二次解码，需源头校验转码而非Redis配置调整。
直接加 --raw 就能解决 90% 的 Redis 中文乱码显示问题，但 ThinkPHP 场景下常因“写入时编码不一致”或“读取后未解码”导致二次乱码——这不是 Redis 本身的问题，而是 PHP 层面的字符流没对齐。
redis-cli 查看中文必须加 --raw
这是最基础、也最容易被忽略的一环。默认 redis-cli 会对非 ASCII 字符做转义（比如把“张三”变成 "\xe5\xbc\xa0\xe4\xb8\x89"），看起来像乱码，其实是安全转义。
- 临时查一个 key：
redis-cli -p 6379 --raw get USER_INFO - 进入交互模式：
redis-cli -p 6379 --raw，之后再执行get USER_INFO - Windows 下还需先执行
chcp 65001，否则控制台用 GBK 解释 UTF-8 字节流，仍会显示方块或问号
ThinkPHP 写入 Redis 前必须确保是 UTF-8 字节流
ThinkPHP 默认以 UTF-8 处理字符串，但如果你从表单、文件上传、旧数据库（GBK）等渠道拿到数据，可能混入 GBK 编码字节。Redis 存的是原始字节，不会自动转码。
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 检查来源：
$name = $request->post('name');→ 用mb_detect_encoding($name)看实际编码 - 强制转 UTF-8（稳妥写法）：
$name = mb_convert_encoding($name, 'UTF-8', 'auto'); - 存入前验证：
if (!mb_check_encoding($name, 'UTF-8')) { throw new Exception('Invalid encoding for Redis'); } - 写入 Redis 不要用
json_encode()后再存——除非你明确需要 JSON 字符串；直接Cache::set('user_name', $name);即可（ThinkPHP 5.1+ 默认用serialize，但字符串值仍是原生 UTF-8 字节）
ThinkPHP 读取 Redis 后不要二次 decode
很多人看到 Cache::get('user_name') 返回的是 "张三" 这种形式，就手动 urldecode() 或 pack('H*', ...)，结果反而破坏 UTF-8 字节序列。
立即学习“PHP免费学习笔记（深入）”；
- ThinkPHP 的
Cache类读取后已还原为 PHP 字符串，echo或json_encode()都能正常输出中文 - 如果返回的是乱码字符串（如“涓涓”），说明写入时就是 GBK 字节，此时应统一源头编码，而不是在读取端补救
- 避免错误操作：
utf8_decode($value)、iconv('UTF-8', 'GBK', $value)——这些会把本就正确的 UTF-8 字节强行转码，造成不可逆损坏
完整可运行代码片段（ThinkPHP 6.x）
// 控制器中示例
public function saveUser()
{
$name = $this->request->post('name', '');
// 强制转 UTF-8 并校验
$name = mb_convert_encoding($name, 'UTF-8', 'auto');
if (!mb_check_encoding($name, 'UTF-8')) {
throw new hinkException('Name encoding invalid');
}
// 直接存（ThinkPHP Cache 默认使用 serialize + UTF-8 安全）
hinkCache::store('redis')->set('user_name', $name, 3600);
return json(['code' => 0, 'msg' => 'OK']);
}
public function getUser()
{
$name = hinkCache::store('redis')->get('user_name');
// $name 已是合法 UTF-8 字符串，可直接输出
return json(['code' => 0, 'name' => $name]);
}
关键点不在 Redis 配置，而在于整个链路：HTTP 请求体 → PHP 接收 → 转码校验 → Cache 写入 → Cache 读取 → HTTP 响应。只要中间任何一环用了 GBK 字节却当 UTF-8 处理，就会在某个环节突然崩出乱码——而那个环节往往不是 Redis 本身。
