Laravel 9 staging环境Tinker查询MySQL特殊字符编码异常问题

问题本质 #

数据库存储内容正常，但Laravel（API/Tinker）返回乱码（如单引号’变成’），属于UTF-8字符被当作ISO-8859-1解析后二次编码的典型场景。

排查与修复步骤 #

• 验证数据库连接的实际编码
  直接在Tinker中执行命令，确认Laravel实际使用的连接编码：

  DB::select('show variables like "character_set_connection"');
  

  检查结果是否为utf8mb4，同时确认：

  • Staging环境的.env文件中DB_CHARSET=utf8mb4是否配置正确
  • AWS ECS任务定义中的环境变量是否覆盖了.env的数据库编码配置

• 检查PHP默认字符集
  执行命令查看PHP全局字符集设置：

  php -i | grep default_charset
  

  确保输出为default_charset => UTF-8 => UTF-8，若不是则修改php.ini中的对应配置，或在Dockerfile中添加：

  RUN echo "default_charset = 'UTF-8'" >> /usr/local/etc/php/php.ini
  

• 强制Laravel响应编码
  确认API响应头的Content-Type是否包含charset=utf-8，可在AppServiceProvider中全局强制设置：

  public function boot()
  {
      \Illuminate\Support\Facades\Response::macro('utf8', function () {
          return $this->header('Content-Type', 'application/json; charset=utf-8');
      });
  }
  

  路由中使用时可直接链式调用：return response()->json($data)->utf8();

• 检查容器系统字符集
  进入Staging的ECS容器，执行locale命令，确认LANG/LC_ALL为UTF-8格式（如en_US.UTF-8）。若为C或POSIX，需在Dockerfile中添加locale配置：

  RUN apt-get update && apt-get install -y locales && rm -rf /var/lib/apt/lists/*
  RUN locale-gen en_US.UTF-8
  ENV LANG en_US.UTF-8
  ENV LC_ALL en_US.UTF-8
  

• 确认数据库驱动类型
  执行命令检查PDO驱动是否为mysqlnd（对utf8mb4支持更完善）：

  php -i | grep PDO
  

  若为旧版mysql驱动，需切换为mysqlnd（可通过重新编译PHP或更换基础镜像实现）

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