MySQL与PostgreSQL数据库连接参数配置模板详解

在企业级环境中部署QoderWake数字员工集群，后端数据库的配置是保障会话状态持久化和系统稳定性的基石。其中，Session账本的存储尤为关键，它直接关系到用户会话的连续性和数据一致性。官方推荐使用PostgreSQL 14及以上版本，并强制要求启用SSL加密，同时连接池最大连接数需设置为200。如果因现有技术栈限制必须选用MySQL，则需要特别注意禁用autoReconnect功能，并确保驱动版本不低于8.0.33。

为了确保Harness-First框架的会话账本存储要求得到满足，无论是选择MySQL还是PostgreSQL，其连接参数都必须严格遵循标准化的配置模板。下面我们就来详细拆解这两种数据库的具体配置方法。

一、PostgreSQL连接参数配置

作为首选的Session存储引擎，PostgreSQL的配置核心在于启用SSL加密通信并构建一个高可用的连接池。任何网络抖动都可能导致会话状态丢失，因此连接字符串里必须包含强制SSL验证和精细的超时控制参数。

首先，你需要编辑QoderWake的核心配置文件 config/harness.yaml，定位到 session_store 节点进行配置：

1. 将 host 明确设置为内网PostgreSQL主节点的IP地址，port 则显式指定为5432。这里切忌依赖默认值，显式声明能避免许多潜在的推导错误。

2. dbname 需要设置为专用的会话数据库，例如 qoder_session_prod。务必注意，这个库应该独立存在，不要与任何业务数据库混用，以保证隔离性和性能。

3. 安全层面，需要配置 sslmode=verify-full 以启用最严格的SSL证书验证。同时，记得将CA证书路径正确挂载到容器或服务器的指定位置，比如 /etc/qoder/ssl/root.crt。

4. 最后，在连接URL的末尾，务必追加一组连接优化参数：?connect_timeout=10&keepalives=1&keepalives_idle=60&keepalives_interval=10。这些参数能有效管理连接生命周期，应对不稳定的网络环境。

二、MySQL连接参数配置

当企业现有基础设施只支持MySQL时，可以通过Quarkus JDBC驱动进行适配。但这里有几个“坑”需要提前避开：一是MySQL 8.0+默认的caching_sha2_password认证插件可能引发兼容性问题；二是必须禁用自动重连功能，否则可能导致事务意外中断。

配置主要在 application.yml 文件中进行：

1. 在定义数据源时，db-kind 属性必须显式设置为 mysql，框架依赖此标识来加载正确的驱动。

2. jdbc.url 需要采用完整的格式，其中包含了字符集、时区、SSL以及关键的自动重连设置：jdbc:mysql://[host]:[port]/[dbname]?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8&allowPublicKeyRetrieval=true&useSSL=false&autoReconnect=false。请特别注意 autoReconnect=false 是必须项。

3. 驱动方面，将 quarkus.datasource.jdbc.driver 明确指定为 com.mysql.cj.jdbc.Driver，并且确保其版本在8.0.33及以上，以获取最佳的稳定性和功能支持。

4. 连接池的参数也不容忽视：max-size 建议不低于30，min-size 可设为10，同时 initial-size 必须与 min-size 保持一致，避免启动时的连接震荡。

5. 安全最佳实践：数据库用户名和密码应通过 quarkus.datasource.username 和 quarkus.datasource.password 引用环境变量，绝对禁止在配置文件中硬编码敏感凭证。

三、双数据库共存配置策略

实际上，QoderWake支持更灵活的架构，允许将会话账本和技能元数据分离存储。例如，你可以用性能更优、事务一致性更强的PostgreSQL来承载Session账本，而将技能库的关系型索引放在已有的MySQL实例中。这需要在Harness-First框架中声明两个独立的数据源。

1. 在 config/harness.yaml 的 data_sources 节点下，分别定义 session_db 和 skill_index_db 两个子项。

2. 为 session_db 指定 type: postgresql，并填入前述的PostgreSQL连接参数；为 skill_index_db 指定 type: mysql，并关联上MySQL的连接参数。

3. 接下来进行绑定：在 session_store.backend 中填入 session_db；在 skill_registry.index_backend 中填入 skill_index_db。这样框架就知道该将数据写入何处。

4. 执行集群安装脚本 ./install-harness.sh --mode=cluster 时，脚本会自动对这两个数据源的连通性和操作权限进行预校验。

5. 部署完成后，运行健康检查命令 qoder-cli db health-check --all 进行验证。当终端同时输出 session_db: OK 与 skill_index_db: OK 时，才意味着双数据库配置已完全就绪。