Delphi 10.2 Tokyo适配旧项目SQLite执行报错求助

嘿，我之前也踩过不少Delphi老旧项目适配新版本的坑，尤其是SQLite相关的运行时错误，咱们一步步来拆解这个问题：

第一步：先拿到完整的错误细节，别让模糊提示卡着你 #

你现在看到的Error executing SQL. Error 1: SQL ...信息太不全了，Error 1一般是SQL语法问题，但没看到具体执行的SQL和完整错误描述根本没法定位。赶紧给你的错误处理加一段代码，把关键信息打出来：

try
  // 这里是你执行SQL的代码，比如Query.Open/ExecSQL之类的
except
  on E: Exception do
  begin
    // 用弹窗或者日志输出完整信息
    ShowMessage(Format('SQL错误详情: %s'#13#10'执行的SQL语句: %s', [E.Message, (Sender as TSQLQuery).SQL.Text]));
    // 别吞掉错误，继续抛出方便调试
    raise;
  end;
end;

拿到完整SQL后，你甚至可以直接复制到SQLite官方的sqlite3.exe里执行，看看是不是语法本身就有问题。

第二步：锁定你用的SQLite封装库，排查版本兼容性 #

从FieldAsInteger这个函数来看，大概率是这两类库：

• Delphi自带的FireDAC：10.2 Tokyo的FireDAC对SQLite的驱动比老版本严格多了，比如默认开启了Strict SQL模式，旧项目的SQL可能不符合新规范。你可以在FireDAC的连接参数里加一句SQLite.StrictSQL=False，关掉严格模式试试。另外要确认FireDAC的SQLite驱动版本和你项目原来用的是不是差异太大。
• 第三方库（比如SQLite3Delphi、UniDAC）：如果你升级了第三方库的最新版本，要注意有些新版本可能不再兼容Delphi 10.2的某些特性，比如Unicode字符串处理——10.2是纯Unicode环境，老项目可能用的是ANSI字符串，SQL语句里的字符串拼接容易出编码问题。

第三步：检查SQL语句的兼容性坑 #

老旧项目的SQL很可能和新版SQLite不兼容，常见的坑有这些：

• 误用AUTOINCREMENT：SQLite里只有INTEGER PRIMARY KEY AUTOINCREMENT是合法的，老项目可能写了INT AUTOINCREMENT这种错误语法，新版SQLite会直接报错。
• 硬拼SQL导致的编码/语法错误：老项目可能直接把字符串拼进SQL，在Unicode环境下很容易乱码，而且容易触发SQL语法错误。赶紧改成参数化查询，比如：

// 别再这么写了：
Query.SQL.Text := 'SELECT * FROM user WHERE id = ' + IntToStr(UserID);
// 换成参数化，既安全又兼容：
Query.SQL.Text := 'SELECT * FROM user WHERE id = :UserID';
Query.ParamByName('UserID').AsInteger := UserID;

• 使用了新版SQLite的保留关键字：比如USER、GROUP这些，如果你的表名/字段名是这些，老版本可能放过，但新版本必须加反引号（`user`）包裹。

第四步：检查数据库文件本身的问题 #

如果数据库是老版本SQLite创建的，新版封装库可能读不动，或者需要升级格式。你可以用SQLite官方的sqlite3.exe工具打开数据库，执行：

PRAGMA user_version; -- 查看数据库版本
VACUUM; -- 优化并升级数据库格式

另外要确保你用的sqlite3.dll是最新版本，而且和你的Delphi项目位数匹配（32位项目用32位dll，64位用64位），位数不匹配也会抛出莫名其妙的SQL错误。

第五步：确认封装库的初始化步骤没漏 #

有些SQLite封装库需要在程序启动时初始化，比如FireDAC要调用FDManager.Initialize;，第三方库可能需要手动加载sqlite3.dll。如果初始化没做对，也会导致运行时SQL执行失败。

内容的提问来源于stack exchange，提问作者Leighton F.