PHP使用Redis作为计数器时获取数据返回冒号的原因排查

我用多线程PHP代码将Redis作为计数器使用，运行过程中发现获取到的计数器值偶尔会带有冒号（例如:5、:9），有时又能正常返回数字。怀疑是不是循环执行过快导致Redis未及时处理？以下是输出结果及相关代码：

输出结果 #

cclilshy@192 debug % php st.php
registerRedis success!
registerSocket success!
1
2
3
1
2
string(2) ":5"
1
2
3
string(2) ":9"
3
string(1) "9"

// the up is the output. Why?

相关代码 #

$func = function($handle){
    for($i=0;$i<3;$i++){
        echo $handle->counter().PHP_EOL;
    }

    var_dump($handle->total());
};

// $handle->counter() :
public function counter($record = true){
        if($record = false){
            return $this->count;
        }
        $this->thread->counter();
        $this->count++;
        return $this->count;
}

// $handle->total() :
public function total(){
        return $this->thread->counter(false);
}

// $handle->thread->counter() : 
public function counter($record = true){
        if($record === false){
            return $this->redis->get('thread.' . $this->pids[0] . '.count');
        }
        return $this->redis->incr('thread.' . $this->pids[0] . '.count');
}

问题分析 #

1. 致命语法错误：$handle->counter()方法里的if($record = false)是赋值操作而非比较操作。赋值表达式的结果为false，导致该条件永远不成立——无论传入什么参数，都会执行Redis incr和本地$this->count自增逻辑，本地计数器完全与Redis全局计数脱节。
2. 本地计数器与Redis不同步：代码维护了本地$this->count，但既没有从Redis同步初始值，也没有用incr的返回值更新它。多线程环境下，每个线程的本地计数器独立从0开始自增，完全不反映Redis的真实计数。
3. Redis值带冒号的可能原因：
   • 存在错误赋值逻辑：某个地方误用set、append等命令向目标key写入了带冒号的字符串。Redis的incr仅能操作数字类型值，若key对应值为非数字字符串，incr会返回错误；若客户端未处理错误，可能会把异常内容当成返回值输出。
   • 客户端或序列化问题：部分Redis客户端若配置了自动序列化，可能导致值格式异常，但这种情况较少见。

解决方案 #

1. 修复语法错误：将$handle->counter()中的判断改为严格比较：

   public function counter($record = true){
           if($record === false){
               return $this->count;
           }
           $this->thread->counter();
           $this->count++;
           return $this->count;
   }
   

2. 废弃本地计数器，直接依赖Redis：Redis的incr是原子操作，完全可以直接用其返回值作为当前计数，避免本地计数器的同步问题：

   public function counter($record = true){
           if($record === false){
               return $this->thread->counter(false);
           }
           // 直接返回Redis incr的结果，无需维护本地count
           return $this->thread->counter();
   }
   

3. 排查Redis值异常：
   • 手动执行Redis命令GET thread.[你的PID].count，查看目标key的真实值。
   • 检查所有操作该key的代码，确保只有incr或get操作，没有错误的写入逻辑。
   • 确认Redis客户端配置正常，没有开启不必要的序列化或编码转换。

内容的提问来源于stack exchange，提问作者cclilshy