本文由 FlintHub 开发文档归档发布。原始文档日期见标题前缀，来源：暂存20260913/docs/清除sqlite代码计划.md。

清除 SQLite 残留代码计划

背景：SoSite 4.0.0 之前支持 SQLite + MySQL 双数据库，4.0.0 后改为仅 MySQL。

以下列出所有残留的 SQLite 相关代码，评估清除难度和方案。

一、核心文件残留（3 处）

1.1 app/Core/Database.php

清除方案：

• 删除 getDbType() 方法（方法体仅一行 return 'mysql'，无实际价值）
• 删除 str_replace('INSERT OR IGNORE INTO', ...) 的两行兼容代码

难度：⭐ 极低，删 3 行代码

影响：需要确认没有其他地方调用 getDbType()（核查结果见下文，有 3 个地方调用）

1.2 app/Controllers/Admin/DashboardController.php

清除方案：直接删除该行，模板中对应位置也移除"数据库类型"显示（或改为固定显示"MySQL"）

难度：⭐

1.3 app/Controllers/Admin/DatabaseController.php

清除方案：

• 删除 $dbType 变量，模板中改为固定显示"MySQL"
• 保留 CHARSET=utf8 → utf8mb4 替换（这是 SQL 导入时的兼容处理，用于导入旧版 SQLite 备份，保留无害）

难度：⭐

1.4 app/Controllers/Admin/MaintenanceController.php

清除方案：删除该行，模板中 dbType 默认值改为 'mysql' 即可

难度：⭐

1.5 app/Views/admin/database.php

清除方案：类型行改为固定显示 MySQL

难度：⭐

1.6 app/Views/admin/index.php

清除方案：默认值改为 'mysql'，或直接显示 'MySQL'

难度：⭐

1.7 app/Views/admin/maintenance.php

清除方案：默认值改为 'mysql'

难度：⭐

二、插件残留（5 个插件）

2.1 plugins/daily_checkin/hook/init_after.php ⚠️ 最复杂

清除方案：删除整个 else 分支（SQLite 代码），if 条件删除，保留 MySQL 分支代码

难度：⭐⭐ 中等

代码量：约 20 行

2.2 plugins/dev_docs/AdminController.php

清除方案：直接写 updated_at = NOW()，删除三元运算

难度：⭐

2.3 plugins/dev_docs/Plugin.php ⚠️ 最复杂

清除方案：

• 删除 else 分支（SQLite 建表 SQL）
• 方法签名去掉 $dbType 参数
• 仅保留 MySQL 分支代码

难度：⭐⭐ 中等

代码量：约 15 行

2.4 plugins/qa/Plugin.php

清除方案：删除整个 else 分支，if 条件删除，保留 MySQL 建表代码

难度：⭐⭐ 中等

代码量：约 40 行

2.5 plugins/invite/hook/init_after.php

实际上没有 SQLite 残留，只是建表语句用了 MySQL 引擎语法，这在 MySQL-only 下是正常的。无需修改。

三、仅文档描述残留（不影响功能）

3.1 plugins/dev_docs/Plugin.php 中的文档内容

清除方案：这些是 dev_docs 插件中存储的文档内容（HTML），存储在 doc_pages 表的 content 字段中。修改方式：

• 更新 Plugin.php 中 insertDefaultData() 方法里的文档内容 HTML
• 或直接在后台编辑文档页面删除 SQLite 相关内容

难度：⭐⭐ 中等（字符串量大，但无技术难度）

四、config.php 中的残留

当前 config.php 中仍有 DB_TYPE 常量定义：

define('DB_TYPE', 'mysql');

但实际代码中没有任何地方读取 DB_TYPE，数据库连接是硬编码的 MySQL。这个常量可以保留（作为标识），也可以删除。

建议：保留，无危害。

五、Database.php 中的 SQLite 兼容注释

query() 方法中的注释：

// SQLite → MySQL 语法兼容替换（为插件代码兼容，如 qa 插件使用 INSERT OR IGNORE）

清除后应改为：

// MySQL-only，无需兼容替换

六、工作量汇总

七、清除原则

1. 只删 SQLite 分支代码，不影响 MySQL 功能
2. 每个文件单独改，改完 php -l 验证语法
3. 文档内容（dev_docs 中的 HTML）可以最后处理，不影响功能
4. 先改核心文件，再改插件文件

八、操作顺序建议

第 1 步：核心文件（5 个）
  Database.php → DashboardController.php → DatabaseController.php → MaintenanceController.php

第 2 步：后台视图（3 个）
  admin/database.php → admin/index.php → admin/maintenance.php

第 3 步：插件（3 个）
  daily_checkin/init_after.php → dev_docs/AdminController.php → dev_docs/Plugin.php → qa/Plugin.php

第 4 步：文档内容（可选）
  dev_docs/Plugin.php 中的文档 HTML

等指令再动手。