Java 區域變數遮蔽陷阱：SQLiteOpenHelper 建表 SQL 報錯分析

錯誤現場

在 SQLiteOpenHelper 的 onCreate() 中建表：

String TABLE_LOCATIONLABLES = "CREATE TABLE " + TABLE_LOCATIONLABLES + "(" 
    + KEY_LOCID + " INTEGER PRIMARY KEY," 
    + KEY_LOCNAME + " TEXT," + ")";
db.execSQL(TABLE_LOCATIONLABLES);

編譯器報錯：區域變數 TABLE_LOCATIONLABLES 可能未初始化。

根本原因：變數遮蔽

類別已定義 static final String TABLE_LOCATIONLABLES = "locationLables"; 作為表名常數。但在方法內部：

String TABLE_LOCATIONLABLES = "CREATE TABLE " + TABLE_LOCATIONLABLES + "("

這行宣告了同名區域變數，導致：

1. 等號右側的 TABLE_LOCATIONLABLES 指向的是正在宣告的區域變數（尚未賦值）
2. 而非類別常數 this.TABLE_LOCATIONLABLES
3. 編譯器偵測到「讀取未初始化的區域變數」→ 報錯

正確寫法

// 使用不同變數名，或直接拼接
String createTableSql = "CREATE TABLE " + TABLE_LOCATIONLABLES + "("
    + KEY_LOCID + " INTEGER PRIMARY KEY,"
    + KEY_LOCNAME + " TEXT"  // 移除多餘逗號
    + ")";
db.execSQL(createTableSql);

補充：SQL 語法細節

• 最後一個欄位定義後不要有逗號（原碼 TEXT, 會報語法錯）
• 表名、欄位名建議用反引號包裹：`locationLables` 避免關鍵字衝突
• 主鍵建議加 AUTOINCREMENT：INTEGER PRIMARY KEY AUTOINCREMENT

最佳實踐建議

1. 常數命名規範：表名常數用 TABLE_NAME_LOCATION_LABELS，SQL 變數用 sqlCreateTable，語義區分明確
2. 提取建表 SQL 為私有常數：

private static final String SQL_CREATE_LOCATION_LABELS = 
    "CREATE TABLE " + TABLE_LOCATION_LABELS + " (" +
    KEY_LOC_ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +
    KEY_LOC_NAME + " TEXT NOT NULL" +
    ")";

3. 使用 Room / ORM 框架：現代專案建議遷移至 Room，編譯期驗證 SQL，消除此類低級錯誤