SQL 插入語句誤用 WHERE 導致語法錯誤：正確用 UPDATE 實現條件寫入

錯誤代碼

String sql = "INSERT INTO userInfo(NAME, EMPCODE, ...) VALUES (?,?,...) WHERE userId=?";

報錯：You have an error in your SQL syntax ... near 'WHERE userId=1434594273200'

根本原因

標準 SQL INSERT 語法不支援 WHERE 子句。INSERT 用於新增行，目標行不存在，無法按條件定位。

正確解決方案

場景 A：記錄不存在則新增，存在則更新

-- MySQL
INSERT INTO userInfo (userId, NAME, EMPCODE, ...)
VALUES (?, ?, ?, ...)
ON DUPLICATE KEY UPDATE
    NAME=VALUES(NAME), EMPCODE=VALUES(EMPCODE), ...;

-- SQL Server
MERGE INTO userInfo AS target
USING (VALUES (?, ?, ?, ...)) AS source (userId, NAME, EMPCODE, ...)
ON target.userId = source.userId
WHEN MATCHED THEN UPDATE SET NAME=source.NAME, EMPCODE=source.EMPCODE, ...
WHEN NOT MATCHED THEN INSERT (userId, NAME, EMPCODE, ...) VALUES (source.userId, source.NAME, source.EMPCODE, ...);

-- PostgreSQL
INSERT INTO userInfo (userId, NAME, EMPCODE, ...)
VALUES (?, ?, ?, ...)
ON CONFLICT (userId) DO UPDATE SET NAME=EXCLUDED.NAME, EMPCODE=EXCLUDED.EMPCODE, ...;

前提：userId 為主鍵或唯一索引。

場景 B：純更新現有記錄

UPDATE userInfo
SET NAME=?, EMPCODE=?, DEPTCODE=?, ...
WHERE userId=?;

場景 C：條件插入（不存在才插）

-- MySQL
INSERT INTO userInfo (userId, NAME, ...)
SELECT ?, ?, ... FROM DUAL
WHERE NOT EXISTS (SELECT 1 FROM userInfo WHERE userId=?);

-- SQL Server
IF NOT EXISTS (SELECT 1 FROM userInfo WHERE userId=?)
    INSERT INTO userInfo (userId, NAME, ...) VALUES (?, ?, ...);

Java 代碼修正示例

// 使用 UPDATE
String sql = "UPDATE userInfo SET NAME=?, EMPCODE=?, DEPTCODE=?, SEX=?, TEL=?, MOBILE=?, STATE=?, USERTYPE=?, ADDRESS=?, POSTALCODE=?, STATION=?, QQ=? WHERE userId=?";
try (PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setString(1, name);
    // ... set other params
    ps.setLong(13, userId);
    ps.executeUpdate();
}

最佳實踐

1. 明確語義：新增用 INSERT，修改用 UPDATE，合併用 MERGE/ON DUPLICATE KEY。
2. PreparedStatement 防注入，佔位符 ? 對應 setX 方法。
3. 事務控制：批量操作時關閉自動提交，統一 commit/rollback。
4. 主鍵策略：業務主鍵 (userId) vs 代理主鍵 (auto_increment id)，根據業務選型。

常見誤區對比

SQL 語法嚴格區分 DML 操作類型，掌握各資料庫的合併寫法，避免在應用層邏輯判斷後分發兩條語句（易產生競態條件）。