SQLite 报错 #7: unrecognized token 的深度解析与避坑指南

1次阅读

共计 2346 个字符，预计需要花费 6 分钟才能阅读完成。

第一次在 SQLite 中看到 #7: unrecognized token 这个报错时，我也是一头雾水。错误通常长这样：

Error: unrecognized token: "'" (code 1 SQLITE_ERROR)

这个错误其实是 SQLite 在告诉我们：它遇到了一个它不认识的符号或字符组合。就像我们读文章时遇到不认识的字会卡壳一样，SQLite 的词法分析器在解析 SQL 语句时也会遇到类似情况。

SQLite 执行 SQL 语句时，会先把整条语句拆分成一个个 token（可以理解为 SQL 中的 ” 单词 ”）。这个过程就像我们阅读时把句子拆分成单词一样。当遇到无法识别的字符组合时，就会抛出unrecognized token 错误。

SQLite 的 token 包括：

关键字（如 SELECT、INSERT）
标识符（表名、列名）
运算符（如 =、>）
字面量（数字、字符串）
分隔符（逗号、括号）

这是新手最容易犯的错误。比如：

INSERT INTO users (name) VALUES ('O'Reilly');

这里的单引号提前结束了字符串，导致 Reilly' 成了无法识别的 token。

现在很多应用会在 SQLite 中存储 JSON，格式错误也会触发这个问题：

INSERT INTO products (data) VALUES ('{"name":"phone","price": 99}'); -- 正确
INSERT INTO products (data) VALUES ('{"name":"phone""price": 99}'); -- 缺少逗号

CREATE TABLE order (id INTEGER); -- order 是保留字

SELECT * FROM my-table; -- 连字符会被误认为减号

SELECT * FROM users -- 这里有个注释
WHERE name = 'John'

import sqlite3

try:
    conn = sqlite3.connect('example.db')
    cursor = conn.cursor()

    # 正确使用参数化查询
    name = "O'Reilly"cursor.execute("INSERT INTO users (name) VALUES (?)", (name,))

    # 处理保留字
    cursor.execute("CREATE TABLE \"order\"(id INTEGER)")

    conn.commit()
except sqlite3.Error as e:
    print(f"SQLite error: {e}")
finally:
    conn.close()

import java.sql.*;

public class SQLiteDemo {public static void main(String[] args) {
        Connection conn = null;
        try {conn = DriverManager.getConnection("jdbc:sqlite:example.db");

            // 参数化查询
            String name = "O'Reilly";
            PreparedStatement stmt = conn.prepareStatement("INSERT INTO users (name) VALUES (?)");
            stmt.setString(1, name);
            stmt.executeUpdate();

            // 处理保留字
            Statement createStmt = conn.createStatement();
            createStmt.execute("CREATE TABLE \"order\"(id INTEGER)");

        } catch (SQLException e) {System.err.println("SQLite error:" + e.getMessage());
        } finally {try { if (conn != null) conn.close();} 
            catch (SQLException e) {/* ignore */}
        }
    }
}

import re

def is_valid_input(input_str):
    # 基本 SQL 注入防护
    pattern = r"^[a-zA-Z0-9_\-\.@]+$"
    return re.match(pattern, input_str) is not None

EXPLAIN INSERT INTO users (name) VALUES ('O''Reilly');

这个命令会显示 SQLite 如何解析和执行你的语句。

def trace_callback(query):
    print(f"Executing: {query}")

conn.set_trace_callback(trace_callback)

如何设计一个自动化 SQL 校验中间件，能在代码提交前捕获这类语法错误？
除了参数化查询，还有哪些方法可以防止 SQL 注入同时避免 unrecognized token 错误？
如何利用 SQLite 的 PRAGMA 语句优化错误信息的可读性？

unrecognized token错误看似简单，但它背后涉及 SQLite 的词法分析机制、SQL 注入防护、数据格式处理等多个重要概念。通过本文的解析和示例，希望你能在未来的开发中从容应对这类问题，写出更健壮的 SQLite 代码。记住，预防胜于治疗，良好的编码习惯和充分的测试是避免这类错误的最佳实践。

正文完