根本原因是php客户端未显式声明字符集，导致postgresql默认使用sql_ascii或错误client_encoding；须在.env中设db_charset=utf8、在config/database.php的pgsql连接块中硬编码'charset' => 'utf8'，并用db::select("show client_encoding")验证返回utf8。
在 Laravel 项目中连接 PostgreSQL 时，若中文、emoji 或特殊符号显示为问号、乱码或插入失败，根本原因往往不是数据库本身编码问题，而是 PHP 客户端未显式声明字符集，导致 PostgreSQL 默认使用 SQL_ASCII 或错误的 client_encoding。必须在连接建立阶段就强制指定 UTF8，而非依赖环境变量或服务端配置。
修改 .env 中的 DB_CONNECTION 和连接参数
打开项目根目录下的 .env 文件，确认以下三处设置：
第一，将 DB_CONNECTION=pgsql —— 这是启用 PostgreSQL 驱动的前提，设为 mysql 或 sqlite 会导致后续所有配置失效；
第二，确保 DB_HOST、DB_PORT（默认 5432，金仓为 54321）、DB_DATABASE、DB_USERNAME、DB_PASSWORD 均填写正确且可连通；
第三，【关键】追加 DB_CHARSET=utf8 —— Laravel 的 pgsql 驱动会将其转为 client_encoding='UTF8' 发送给 PostgreSQL，缺省时可能继承系统 locale 导致不一致；
保存后执行 php artisan config:clear 清除缓存，否则新配置不会生效。
在 config/database.php 中强制设置 client_encoding
仅靠 .env 的 DB_CHARSET 不足以覆盖所有场景，尤其当使用多个连接或自定义连接池时，必须在底层驱动配置中硬编码字符集声明。
打开 config/database.php，定位到 'connections' => [ 'pgsql' => [...]] 区块；
在该数组内添加或修改 'options' => [PDO::ATTR_EMULATE_PREPARES => false] —— 这能避免 PHP 模拟预处理导致的编码转换异常；
紧接着，在同一层级新增：'charset' => 'utf8'；
⚠️ 注意：此处写 'utf8' 即可，PostgreSQL 实际使用的是 UTF8 编码名，Laravel 内部会自动映射，不要写成 'UTF-8' 或 'utf8mb4'，后者不被 PostgreSQL 识别。
验证客户端字符集是否生效
进入 Tinker 环境：php artisan tinker；
执行：DB::connection()->getPdo()->getAttribute(PDO::ATTR_CLIENT_VERSION) —— 此命令仅返回客户端版本，不能验证编码；
真正有效的验证方式是直接查询 PostgreSQL 的当前 client_encoding：
DB::select("SHOW client_encoding")[0]->client_encoding；
如果返回结果是 UTF8，说明配置成功；若返回 SQL_ASCII 或其他值，则前两步中某处配置未生效，需回溯检查 .env 是否被 config:cache 锁定、database.php 中是否拼写错误、或 PostgreSQL 服务端是否限制了 client_encoding 设置（极少见，通常发生在云数据库白名单策略中）。
