1. ThinkPHP 8.0 调用 MySQL 存储过程踩坑现场为什么 Db::query 有时返回空数组先说结论ThinkPHP 8.0 默认跑在 think-orm 4.0 上底层还是 PDO但 ORM 在 PDO 外面包了一层连接管理和查询构造器。你直接写Db::query(CALL ...)大概率能跑通可一旦存储过程里带SELECT结果集、又带OUT输出参数或者你在同一个请求里连续调两次就会遇到「第一次有数据、第二次返回空」「报 Cannot execute queries while other unbuffered queries are active」这类问题。这不是 ThinkPHP 的 bug是 PDO 游标没关干净。存储过程在业务里其实很常见报表统计、批量校验、分页联表查询写成一条CALL比在 PHP 里拼十几行 join 清爽得多。但 ThinkPHP 的文档对存储过程着墨很少很多人卡在三个地方——连接参数没开对、参数绑定类型写错、游标没释放。这篇就按「能直接复制去跑」的标准把 database.php 配置、Db::query 与 Db::execute 的分工、PDO 参数绑定、以及用 TaoToken 统一管理多环境 Key 这几件事串起来讲完。适合谁看正在用 ThinkPHP 8.0 做后台、需要调存储过程但被返回空数组或游标报错卡住的开发者以及手上有多套环境本地/测试/生产、Key 散落在各个 .env 里想统一收口的团队。我试过最典型的翻车场景是这样的一个带分页的存储过程sp_task_user_check_list第一次调用正常返回 20 条同一个请求里翻第二页再调结果fetchAll返回空数组日志里还飘一句PDO::prepare(): MySQL server has gone away或者游标相关的警告。根因就是$stmt-closeCursor()没执行前一个结果集还挂在连接上PDO 不允许在未读完的结果集上再发新查询。下面从配置开始一步步拆。2. TaoToken 前置准备统一 Key 与 API 通道管住多环境密钥在写存储过程调用之前先把「密钥从哪来」这件事定下来否则你本地一套、测试一套、生产一套改起来容易漏。TaoToken 在这里的角色是统一 Key 与 API 通道你可以在一个控制台里创建不同用途的 Key按环境或按项目分配代码里只认一个 Base URL 加一个 Key 变量切换环境时改配置而不是改代码。具体操作路径都在官网内不需要额外工具第一步打开控制台创建 Key。地址是https://taotoken.net/console登录后在 API Keys 页面新建一个 Key建议命名带上环境和用途比如tp8-local-sp、tp8-prod-sp方便后面排查是哪把 Key 出的问题。创建完立刻复制页面刷新后就不再完整显示。第二步确认你要用的模型或通道。如果你只是拿 TaoToken 做密钥统一管理、请求转发到自己的模型服务那在控制台里配置好对应的通道即可如果你还要顺带验证模型对话能力可以去模型对话页面试一条https://taotoken.net/models模型对话入口确认 Key 能正常鉴权。第三步把 Key 写进 ThinkPHP 的 .env不要硬编码进 database.php。ThinkPHP 8.0 用env()函数读取配置里引用变量名即可。这样本地.env和线上.env内容不同但 database.php 完全一致避免把生产 Key 提交进 Git。这里要提醒一句TaoToken 是统一 Key 与 API 通道管理不是让你把数据库密码也塞进去。数据库连接参数host、database、username、password仍然走你自己的 MySQL 配置TaoToken 管的是对外 API 调用的那套 Key。两者别混。如果你后面要做长期编码或 Agent 类任务可以了解下 Coding Planhttps://taotoken.net/coding-plan它面向的是持续性的编码场景单纯做存储过程调试用不上但团队里如果有人同时在跑 Agent统一到一套 Key 体系里会省事。接入文档在https://taotoken.net/doc遇到鉴权细节可以对照看。3. 可复制配置database.php 连接参数与存储过程调用代码片段这一节是核心直接给能粘贴的配置和代码。先看 database.php。ThinkPHP 8.0 的数据库配置在config/database.php关键点是params里要开PDO::ATTR_EMULATE_PREPARES false否则参数绑定会走模拟预处理存储过程的OUT参数拿不到值类型绑定也会失效。?php // config/database.php return [ default env(DB_DRIVER, mysql), connections [ mysql [ type mysql, hostname env(DB_HOST, 127.0.0.1), database env(DB_NAME, your_db), username env(DB_USER, root), password env(DB_PASS, ), hostport env(DB_PORT, 3306), charset utf8mb4, prefix , debug env(APP_DEBUG, false), // 关键关闭模拟预处理保证 OUT 参数与类型绑定生效 params [ \PDO::ATTR_EMULATE_PREPARES false, \PDO::ATTR_STRINGIFY_FETCHES false, \PDO::ATTR_ERRMODE \PDO::ERRMODE_EXCEPTION, ], // 统一 API 通道 KeyTaoToken 管理按环境注入 api_base_url env(TAOTOKEN_BASE_URL, https://taotoken.net/api), api_key env(TAOTOKEN_API_KEY, ), ], ], ];对应的.envDB_HOST127.0.0.1 DB_NAMEyour_db DB_USERroot DB_PASSyour_password DB_PORT3306 TAOTOKEN_BASE_URLhttps://taotoken.net/api TAOTOKEN_API_KEYsk-你的Key然后是存储过程调用。先明确Db::query和Db::execute的分工Db::query用于有结果集返回的语句SELECT、带结果集的CALL返回数组Db::execute用于写操作INSERT、UPDATE、不带结果集的CALL返回受影响行数。存储过程如果既写数据又返回结果集用Db::query。下面这段是带输入参数和分页的调用用 PDO 原生 prepare 绑定类型明确?php use think\facade\Db; function getTaskUserList(int $taskId, int $page, int $limit, string $keyword): array { $pdo Db::connect()-connect(); // 拿到底层 PDO 实例 $sql CALL sp_task_user_check_list(:task_id, :page, :limit, :keyword); $stmt $pdo-prepare($sql); $stmt-bindValue(:task_id, $taskId, \PDO::PARAM_INT); $stmt-bindValue(:page, $page, \PDO::PARAM_INT); $stmt-bindValue(:limit, $limit, \PDO::PARAM_INT); $stmt-bindValue(:keyword, $keyword, \PDO::PARAM_STR); $stmt-execute(); $result $stmt-fetchAll(\PDO::FETCH_ASSOC); $stmt-closeCursor(); // 必须释放游标否则后续调用报错 return $result; }注意closeCursor()这一行很多人漏掉就是它导致第二次调用返回空。如果你用Db::query直接传参写法是Db::query(CALL sp_task_user_check_list(?, ?, ?, ?), [$taskId, $page, $limit, $keyword])但这种方式对OUT参数无能为力所以带输出参数时还是走 PDO 原生绑定。带OUT输出参数的存储过程绑定方式不同要用变量引用?php use think\facade\Db; function callWithOutParam(int $userId): array { $pdo Db::connect()-connect(); $pdo-prepare(CALL sp_user_stat(:uid, total))-execute([:uid $userId]); // 单独查输出变量 $row $pdo-query(SELECT total AS total)-fetch(\PDO::FETCH_ASSOC); return [total $row[total] ?? 0]; }这里total是 MySQL 会话变量存储过程里用OUT total INT接收后赋值给total再单独SELECT出来。这是 MySQL 存储过程 PDO 的标准套路ThinkPHP 层不改变这个机制。4. 验证请求与成功结果一条带输出参数的存储过程跑通配置写完得有个能验证的最小存储过程。在 MySQL 里建一个DELIMITER $$ CREATE PROCEDURE sp_user_stat(IN p_uid INT, OUT p_total INT) BEGIN SELECT COUNT(*) INTO p_total FROM users WHERE id p_uid; END$$ DELIMITER ;然后在 ThinkPHP 控制器里调用并打印结果?php namespace app\controller; use think\facade\Db; class SpTest { public function index() { $pdo Db::connect()-connect(); $stmt $pdo-prepare(CALL sp_user_stat(:uid, total)); $stmt-bindValue(:uid, 1, \PDO::PARAM_INT); $stmt-execute(); $stmt-closeCursor(); $row $pdo-query(SELECT total AS total)-fetch(\PDO::FETCH_ASSOC); return json([code 0, total (int)($row[total] ?? 0)]); } }访问这个路由正常返回{code:0,total:1}就说明整条链路通了database.php 的params生效、PDO 绑定正确、OUT参数能取到值、游标释放干净。如果返回total是 0 或 null先检查存储过程里INTO p_total有没有写对再检查total的SELECT是不是在同一个 PDO 连接上执行的——ThinkPHP 默认复用连接但如果你中间调了Db::connect(other)切了库会话变量就丢了。再验证一次连续调用确认游标问题解决for ($page 1; $page 3; $page) { $list getTaskUserList(1001, $page, 20, ); echo page {$page}: . count($list) . rows\n; }三次都返回正常行数说明closeCursor()起了作用。这一步是很多人忽略的回归验证单次调用成功不代表连续调用没问题。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth 对照存储过程本身报错和 API 通道报错要分开看下面按真实报错对照。报错一SQLSTATE[HY000]: General error: 2014 Cannot execute queries while other unbuffered queries are active这是最典型的游标未释放。原因上一个CALL的结果集没读完或没closeCursor()。解决每次fetchAll后立刻closeCursor()或者把PDO::MYSQL_ATTR_USE_BUFFERED_QUERY设为 true在params里加\PDO::MYSQL_ATTR_USE_BUFFERED_QUERY true但缓冲查询吃内存大结果集慎用。报错二401 Unauthorized如果你在存储过程之外还调了 TaoToken 的 API 通道401 说明 Key 没带上或带错。检查.env里TAOTOKEN_API_KEY是否为空、请求头是不是Authorization: Bearer sk-xxx。注意 Key 只在创建时完整显示一次复制错了就重新建一把。报错三local proxy failed/ 连接被拒这类通常是 Base URL 写错或网络出口问题。确认TAOTOKEN_BASE_URL是https://taotoken.net/api不要多加斜杠或路径。如果你在容器里跑检查容器 DNS 和出网策略别把本地回环地址当成服务地址。报错四reading choices相关解析错误这通常出现在你同时用 TaoToken 做模型对话、返回体解析失败时。检查请求的Content-Type和返回 JSON 结构别把流式返回当普通 JSON 解析。存储过程调用不涉及这个但同一个项目里两套逻辑混在一起时容易串。报错五OAuth鉴权失败如果你用的是需要 OAuth 的通道token 过期会报这个。重新走一遍授权流程拿新 token别复用旧的。TaoToken 控制台里可以重新生成 Key比手动刷 token 省事。Codex auth.json / CC Switch / Cline MCP 三件套如果你在项目里同时用 Codex 或 Cline 这类工具配置里出现auth.json、CC Switch 或 Cline MCP 时记住三件套必须齐全Base URL、Key、Model ID。缺一个就连不上。Base URL 填https://taotoken.net/apiKey 填控制台生成的Model ID 填你实际要用的模型标识。三个都对上鉴权才过。排障顺序建议先确认存储过程在 MySQL 客户端里能单独跑通再确认 ThinkPHP 连接参数最后才看 API 通道。分层排查比一上来就怀疑框架快得多。6. 语义一致 CTA把 Key 和接入文档收口到一处存储过程调通之后剩下的事就是把密钥管理收口。你可以在 TaoToken 控制台统一创建和管理 Keyhttps://taotoken.net/api-keys按环境分配代码里只读.env变量。接入细节对照文档https://taotoken.net/doc里面有 Base URL、鉴权头、常见返回码的说明遇到 401 或通道问题时直接查。如果你还要验证模型对话能力去模型对话页面发一条测试https://taotoken.net/models如果是团队长期做编码或 Agent 任务Coding Planhttps://taotoken.net/coding-plan能把 Key 和额度统一管起来省得每个人各自维护一套。官网入口在https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content从控制台到文档都能找到。最后留一个实用技巧把存储过程调用封装成一个 Service 类内部统一处理closeCursor()和异常捕获别在每个控制器里重复写 PDO 绑定。这样即使以后换 ORM 版本改动也只在一个文件里。存储过程本身不难难的是连接参数、绑定类型、游标释放这三件事同时对上对上之后就很稳。