您现在的位置：程式碼之家 >> 編程語言 > >> 更多程式語言 >> 程式設計綜合問答

迴圈新增資料失敗？新手除錯必備：提供完整上下文資訊指南

編輯：程式設計綜合問答

在論壇發問「請大神幫我看看問題出在哪裡」卻只貼一張截圖、不提供代碼、資料庫結構、錯誤堆疊、預期與實際行為，這類提問幾乎無法獲得有效解答。本文整理提問必備要素，助你快速定位問題、提高解答率。

為什麼你的問題無人回應？

資訊不足：只有截圖沒有代碼，答主無法重現場景。
缺乏上下文：你沉浸在問題中，假設別人知道你的業務邏輯、資料表結構、輸入資料樣貌。
問題描述模糊：「不對勁」、「有錯誤」無法讓人釐清具體症狀。

提問黃金模板（請直接複製填寫）

目標：想達成什麼功能？（例：批次新增 100 筆訂單到 orders 表）
環境：語言、框架、資料庫版本（例：Java 11、Spring Boot 2.7、MySQL 8.0）
關鍵代碼：貼上最小可重現片段，含迴圈邏輯、SQL 或 ORM 呼叫。
資料庫結構：提供 CREATE TABLE 或欄位型別說明。
測試資料：幾筆範例輸入資料。
預期結果：資料庫應呈現什麼樣子。
實際結果/錯誤訊息：完整堆疊追蹤、錯誤代碼、或錯誤資料截圖。

常見迴圈新增陷阱與檢查清單

陷阱	徵兆	排查重點
Statement/PreparedStatement 重複使用未關閉	資料庫連線洩漏、後續查詢卡死	每次迴圈建立新 `PreparedStatement`，或使用批次更新 `addBatch()/executeBatch()`
事務未提交	資料查不到、但無報錯	確認 `conn.commit()` 或 `@Transactional` 邊界
主鍵衝突/唯一鍵重複	拋出 `Duplicate entry` 例外	檢查 ID 生成策略、是否誤把同一物件重複插入
資料型別不符	`Data truncation`、`SQLIntegrityConstraintViolationException`	核對 Java 型別與資料庫欄位型別、長度

正確初始化 PreparedStatement 範例

String sql = "INSERT INTO orders (user_id, amount, created_at) VALUES (?, ?, ?)";
try (Connection conn = dataSource.getConnection();
     PreparedStatement ps = conn.prepareStatement(sql)) {
    conn.setAutoCommit(false);
    for (OrderDTO dto : orderList) {
        ps.setLong(1, dto.getUserId());
        ps.setBigDecimal(2, dto.getAmount());
        ps.setTimestamp(3, Timestamp.valueOf(LocalDateTime.now()));
        ps.addBatch();
    }
    ps.executeBatch();
    conn.commit();
} catch (SQLException e) {
    // 處理回滾與日誌
}