本文详解 sqlite 在 php 中查询仅返回首行的常见原因及解决方法，重点指出浏览器或开发环境缓存干扰导致的假性问题，并提供验证与清除缓存的实操步骤。
本文详解 sqlite 在 php 中查询仅返回首行的常见原因及解决方法，重点指出浏览器或开发环境缓存干扰导致的假性问题，并提供验证与清除缓存的实操步骤。
在使用 PHP 的 SQLite3 扩展执行 SELECT * FROM player 查询时，若循环遍历结果集（如 while ($row = $res->fetchArray(SQLITE3_ASSOC))）却仅输出第一行（例如 "Jannik"），绝大多数情况下并非代码逻辑错误——你的 PHP 代码本身是正确的：
$res = $this->db->query("SELECT * FROM player");
while ($row = $res->fetchArray(SQLITE3_ASSOC)) {
echo $row['Name'] . "<br>"; // 注意：字段名区分大小写！
}
✅ 上述代码语法无误，能正确遍历所有行——前提是数据库连接正常、SQL 执行成功且未受外部干扰。
⚠️ 真正的“元凶”往往是 客户端或开发环境的缓存机制：
- 浏览器对 PHP 脚本响应进行了强缓存（尤其当响应头含
Cache-Control: max-age=3600或ETag未更新）； - IDE 内置服务器（如 PHP Built-in Server）或本地代理（如 XAMPP 的 Apache）启用了页面级缓存；
- SQLite 数据库文件被其他进程（如 DB Browser for SQLite）以独占模式打开，导致 PHP 读取的是旧快照。
? 验证是否为缓存问题，请立即执行以下三步：
-
强制刷新前端：按
Ctrl + F5（Windows/Linux）或Cmd + Shift + R（macOS）硬刷新，绕过缓存； -
检查响应头：在浏览器开发者工具（Network → Headers）中确认
Cache-Control和Last-Modified是否异常； -
终端直调脚本：在命令行运行
php your_script.php，观察原始输出——若终端显示全部三行（Christian、Jannik、Lena），则 100% 是浏览器缓存所致。
? 关键注意事项：
- SQLite 字段名严格区分大小写：示例表中列为
Name（首字母大写），但代码中若写成$row['name']将返回NULL—— 此时echo输出为空字符串，易被误判为“没循环到”。务必核对PRAGMA table_info(player)输出，统一使用正确大小写； - 始终添加错误检查提升健壮性：
if (!$res) { die("Query failed: " . $this->db->lastErrorMsg()); }
✅ 最终建议：
开发阶段在 PHP 脚本开头添加禁用缓存头，避免干扰调试：
header("Cache-Control: no-cache, must-revalidate, max-age=0");
header("Expires: Sat, 01 Jan 2000 00:00:00 GMT");
header("Pragma: no-cache");
记住：当逻辑看似无懈可击却行为异常时，请先怀疑环境——缓存不是 Bug，而是沉默的守门人。
