QoderWake企业级部署要求Session账本使用PostgreSQL 14+并启用SSL加密、连接池最大200；MySQL仅作备选，需禁用autoReconnect且驱动版本不低于8.0.33。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您正在为QoderWake企业级数字员工集群配置后端数据库连接，需确保MySQL或PostgreSQL参数严格匹配Harness-First框架的会话账本（Session账本）存储要求。以下是针对两种数据库类型的标准化参数设置模板：
一、PostgreSQL连接参数配置
PostgreSQL作为QoderWake推荐的Session账本存储引擎，需启用SSL加密通信并配置高可用连接池。连接字符串必须包含强制SSL验证与连接超时控制，避免因网络抖动导致会话状态丢失。
1、编辑QoderWake配置文件 config/harness.yaml，在 session_store 节点下填入以下参数：
2、设置 host 为内网PostgreSQL主节点IP，port 显式指定为5432，禁止使用默认值隐式推导。
3、将 dbname 设为专用会话库名（如 qoder_session_prod），不得复用业务库。
4、配置 sslmode=verify-full，并同步挂载CA证书路径至 /etc/qoder/ssl/root.crt。
5、在连接URL末尾追加参数：?connect_timeout=10&keepalives=1&keepalives_idle=60&keepalives_interval=10。
二、MySQL连接参数配置
当企业现有基础设施仅支持MySQL时，须通过Quarkus JDBC驱动适配，需规避MySQL 8.0+默认的caching_sha2_password认证插件兼容性问题，并禁用自动重连以防止事务中断。
1、在 application.yml 中定义数据源，db-kind 必须显式设为 mysql。
2、jdbc.url 使用完整格式：jdbc:mysql://[host]:[port]/[dbname]?useUnicode=true&characterEncoding=UTF-8&serverTimezone=GMT%2B8&allowPublicKeyRetrieval=true&useSSL=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支持Session账本与技能元数据分离存储，可将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。
