xiis数据库三方言切换与连接池配置

xiis 数据库层同时兼容 MySQL、PostgreSQL 与 SQLite 三种数据库方言，通过配置项切换，切换后重启程序生效。建表、查询、分页与事务全链路由方言适配层统一处理，站点业务代码不需要为不同方言编写分支。

三种数据库方言的适用场景

MySQL 适合生产环境与高并发场景，默认端口并支持加密连接；PostgreSQL 适合强一致需求，库不存在时自动创建；SQLite 适合单机与轻量场景，单文件库零部署，空库启动自动建表。三者的连接参数中，SQLite 会忽略地址、账号与编码等网络参数。

连接与库设置

连接设置包括启用开关、数据库类型、地址与端口、数据库名称、表前缀、账号密码与编码。表前缀仅允许字母数字与下划线并自动补下划线结尾，自定义前缀可以提高批量自动化攻击的门槛；修改前缀后需要同步重命名已有表，或在初始化时直接使用新前缀。

方言专属参数

连接池与运行参数

最大连接池大小与最大空闲连接数的语义是应用侧与业务侧两个连接池的合计值，按比例自动拆分，避免按单池口径配置导致的连接数翻倍。连接生命周期控制连接的最长使用时间，建议远大于数据库自身的空闲回收时间；心跳间隔在 SQLite 方言下改为日志合并动作。

启动等待时间让数据库与程序并行启动时先等数据库就绪再初始化连接，避免启动瞬间的连接失败；查询缓存过期时间控制查询结果的缓存时长，是数据更新滞后的来源之一，排查数据不一致时优先检查该项。

表前缀与数据安全

表前缀是数据库层的纵深防御项：默认前缀容易被自动化工具识别，自定义前缀可以抬高批量攻击的成本。前缀只允许字母数字与下划线，长度有上限并自动补齐结尾下划线；修改后必须同步重命名已有表，否则程序会找不到数据。初始化数据库时会按当前前缀建表，清理范围也以当前前缀为界。

模板层的查询标签与方言的关系由适配层处理：语句按标准写法书写，占位符重写由驱动回调统一完成，表名前缀按配置替换。写查询时使用完整表名，敏感表由服务层黑名单拦截，与数据库类型无关。

初始化与排查

• 面板支持一键初始化数据库，按当前方言选择对应建表脚本，操作会清理同前缀旧表，必须二次确认
• 连接数比配置值多一倍时，确认程序版本已使用合计值口径，并按合计值重新配置
• 日志出现无效连接提示时，检查数据库空闲回收时间是否大于程序侧的空闲超时
• 切换数据库方言后重启程序，按目标方言重新初始化或迁移数据

数据库方言的兼容工作由适配层承担，使用者的工作集中在连接参数与方言专属项的填写上。把连接池按合计值口径配置、把生命周期与数据库回收时间对齐，三种方言都能稳定支撑高并发访问，切换方言时按目标类型重新初始化或迁移数据即可。