在使用 PDO 执行多表 JOIN 查询（如 task_tag、task、tag）时，若使用 SELECT * 且多张表含有同名列（如 id），PDO 的 FETCH_ASSOC 模式会因键名冲突而覆盖数据——后出现的同名字段值将覆盖先出现的，造成 ID 丢失或错乱。
在使用 pdo 执行多表 join 查询（如 task_tag、task、tag）时，若使用 `select *` 且多张表含有同名列（如 `id`），pdo 的 `fetch_assoc` 模式会因键名冲突而覆盖数据——后出现的同名字段值将覆盖先出现的，造成 id 丢失或错乱。
这是一个在构建 RESTful API（尤其是涉及多对多关系如任务与标签）时非常典型的数据库查询陷阱。根本原因在于：SQL 允许结果集中存在多个同名列，但 PHP 关联数组的键必须唯一。当使用 SELECT * 联查 task_tag、task 和 tag 表时，三者均含 id 字段（task.id、tag.id、task_tag.id），PDO 在将结果映射为 array 时，会按 SELECT 列的顺序依次写入键 'id' —— 最终仅保留最后一个被选中的 id 值（本例中恰为 tag.id），导致原始 task.id 或 task_tag.id 不可访问。
✅ 正确做法是显式指定所需字段，并为可能冲突的列添加别名。以下是优化后的 read() 方法：
function read() {
// 显式列出所有需要的字段，并为重复列名添加语义化别名
$query = "SELECT
task_tag.id AS task_tag_id,
task_tag.id_task,
task_tag.id_tag,
task.id AS task_id,
task.task_name,
tag.id AS tag_id,
tag.tag_name,
tag.color
FROM task_tag
INNER JOIN task ON task_tag.id_task = task.id
INNER JOIN tag ON task_tag.id_tag = tag.id";
$stmt = $this->conn->prepare($query);
$stmt->execute();
return $stmt;
}调用端代码也应同步调整，直接使用带别名的键名，提升可读性与健壮性：
$tasks_arr = ["task_tag" => []];
$index = 0;
while ($row = $stmt->fetch(PDO::FETCH_ASSOC)) {
// 现在每个 ID 都有明确归属，无歧义
$tasks_arr[$index] = [
'task_tag_id' => $row['task_tag_id'],
'task_id' => $row['task_id'],
'task_name' => $row['task_name'],
'tag_id' => $row['tag_id'],
'tag_name' => $row['tag_name'],
'color' => $row['color']
];
$index++;
}
http_response_code(200);
echo json_encode($tasks_arr, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);⚠️ 关键注意事项：
立即学习“PHP免费学习笔记（深入）”；
- *永远避免在生产环境使用 `SELECT `**，尤其在 JOIN 场景下——它不仅引发键覆盖，还降低查询性能、增加网络传输开销，并使接口契约不明确；
- 别名命名需具业务含义（如 task_id、tag_id），而非简单 id1/id2，便于前端消费与后续维护；
- 若需动态构造字段列表（如支持字段筛选），建议在应用层维护白名单映射，而非拼接原始 *；
- 对于复杂关联，可考虑使用视图（View）预定义安全字段集，进一步解耦 SQL 逻辑。
通过显式列选择与合理别名，你不仅能彻底解决 id 覆盖问题，还能让 API 返回结构更清晰、可预测，为后续扩展（如分页、过滤、嵌套资源）打下坚实基础。
