本文详解 php 分类页面中因逻辑错位导致“soon = '2'”商品仅显示一项的问题，通过修正 `while` 循环与条件判断的嵌套关系、消除重复取值、优化 sql 查询结构，实现多商品正确渲染。
在使用 PHP + MySQL 构建电商产品分类页时，一个常见却隐蔽的 Bug 是：用户选择某分类（如 Tech 或 Candles）后，页面仅渲染出一条 soon = '2' 的商品，其余同条件商品全部丢失。根本原因并非数据库数据异常，而是 PHP 控制流逻辑错误——具体表现为：if ($row["soon"] == "2") 判断被错误地置于 while 循环之外，或循环体内存在重复调用 fetch_assoc()，导致游标提前移动、跳过后续记录。
原始代码中存在两个关键缺陷：
- 重复 fetch 导致数据丢失：若在 while 循环内部意外再次调用 $result->fetch_assoc()（如调试残留），将使当前行被跳过，仅处理偶数索引行；
- 条件分支位置错误：if($row["soon"] == "2") 未严格包裹在 while 循环体内，或与 else if 分支逻辑耦合混乱（如 && isset($_POST['tech']) || isset($_POST['candle']) 缺少括号导致运算符优先级错误），造成部分商品被过滤掉。
✅ 正确做法是：确保所有商品渲染逻辑均位于 while ($row = $result->fetch_assoc()) { ... } 内部，且每个 $row 仅被读取一次。以下是重构后的健壮写法：
<div class="card-deck col-lg-12 col-md-12 col-sm-12 justify-content-center text-center">
<?php
// 统一构建查询语句（推荐使用预处理防止SQL注入）
$category = '';
if (isset($_POST['candle'])) $category = 'candle';
elseif (isset($_POST['cloth'])) $category = 'cloth';
elseif (isset($_POST['tech'])) $category = 'tech';
$sql = $category
? "SELECT * FROM products WHERE category = ? AND soon = '2'"
: "SELECT * FROM products WHERE soon = '2'";
// 【强烈建议】使用预处理语句（防注入 + 清晰逻辑）
$stmt = $conn->prepare($sql);
if ($category) $stmt->bind_param('s', $category);
$stmt->execute();
$result = $stmt->get_result();
if ($result && $result->num_rows > 0):
while ($row = $result->fetch_assoc()):
?>
<div class="product_card col-xl-3 col-lg-4 col-md-5 col-sm-12 box-shadow">
<div class="card-header">
<h3 class="product_name my-0 font-weight-normal"><?= htmlspecialchars($row['productName']) ?></h3>
</div>
<div class="card-body">
<img class="pic"
src="productsImages/<?= (int)$row['productID'] ?>.jpeg"
alt="<?= htmlspecialchars($row['productName']) ?>"
height="150" width="120">
<p><?= number_format((float)$row['productPrice'], 2) ?> SEK</p>
<a class="toProduct" href="products_index.php?id=<?= (int)$row['productID'] ?>">
<button class="btn_to_product btn btn-lg btn-outline-dark">Go to product →</button>
</a>
</div>
</div>
<?php
endwhile;
else:
echo '<h2 class="col-12">Sorry!</h2>';
echo '<h3 class="col-12">No available products in this category.</h3>';
endif;
$stmt->close();
$conn->close();
?>
</div>? 关键改进说明：
立即学习“PHP免费学习笔记（深入）”；
- 逻辑归一化：所有 soon = '2' 商品统一在 WHERE 子句中过滤，避免 PHP 层冗余判断；
- 安全强化：使用 htmlspecialchars() 防 XSS，intval() / (int) 强制类型转换防 ID 注入；
- 性能优化：SQL 层过滤减少传输数据量，避免 PHP 循环中 if 判断开销；
- 可维护性：预处理语句明确分离 SQL 结构与参数，便于后期扩展（如分页、排序）。
⚠️ 重要提醒：
- 始终开启 PHP 错误报告：在开发环境顶部添加 error_reporting(E_ALL); ini_set('display_errors', 1);，快速暴露 undefined index 或 fetch_assoc() 失败等致命错误；
- 避免在循环内修改 $result 或重复调用 fetch_* 方法；
- 对用户输入（如 $_POST）永远做校验与转义，绝不直接拼接 SQL。
遵循以上结构，即可彻底解决分类页商品“只显示一个”的问题，并为后续功能迭代打下坚实基础。
