Java Vert.x JDBC连接SQLite如何设置PRAGMA synchronous=NORMAL

你当前启动时手动执行PRAGMA synchronous=NORMAL的写法，在连接池最大连接数设为1、且连接全程不会被回收重建的前提下确实能跑，但存在隐性故障点：一旦连接因为超时、文件锁冲突、异常断开等原因被连接池销毁重建，新连接会直接使用synchronous参数的默认值，你之前的设置会静默失效，没有任何报错提示。

针对SQLite连接级PRAGMA的配置，有两种Vert.x生态原生支持的标准方案，都不需要手动在业务启动阶段执行SQL，能保证所有新建连接都自动带上配置：

方案1：JDBC URL直接拼接参数（优先推荐） #

SQLite JDBC驱动原生支持在连接URL中追加PRAGMA参数，每次新建连接时驱动会自动加载这些配置，代码最简洁，没有额外逻辑开销。

String databaseFile = "sqlite.db";

JDBCPool pool = JDBCPool.pool(
    this.context.getVertx(),
    new JDBCConnectOptions()
        .setJdbcUrl(String.format("jdbc:sqlite:%s?synchronous=NORMAL", databaseFile))
    ,
    new PoolOptions()
        .setMaxSize(1)
        .setConnectionTimeout(CONNECTION_TIMEOUT)
);

如果后续需要加其他连接级参数（比如内存临时表、页缓存大小这类），直接用&在URL后拼接即可。你提到WAL是库级持久化配置，不需要在这里重复设置。

方案2：配置连接池初始化SQL（适合复杂初始化场景） #

如果需要执行多条初始化语句、或者有更复杂的连接配置逻辑，可以直接使用JDBCConnectOptions提供的初始化SQL配置项：连接池在每次创建新连接后，会先按顺序执行你配置的所有初始化SQL，执行成功的连接才会放入池中供业务使用，从机制上避免了配置遗漏的问题。

String databaseFile = "sqlite.db";

JDBCPool pool = JDBCPool.pool(
    this.context.getVertx(),
    new JDBCConnectOptions()
        .setJdbcUrl("jdbc:sqlite:".concat(databaseFile))
        // 支持多次调用添加多条初始化语句
        .addConnectionInitSql("PRAGMA synchronous=NORMAL")
    ,
    new PoolOptions()
        .setMaxSize(1)
        .setConnectionTimeout(CONNECTION_TIMEOUT)
);

另外你选择单连接池配置的思路是完全正确的：SQLite的写锁是库级粒度，同一时间仅能执行一个写操作，单应用内配置多连接不仅不会提升写性能，反而会引入锁等待、连接调度的额外开销，单连接搭配WAL模式完全可以支撑跨进程并发访问的场景。

内容的提问来源于stack exchange，提问作者andykais