Workflow项目中MySQL连接密码转义问题解析

问题背景

在使用Workflow项目连接MySQL数据库时，开发者可能会遇到一个常见问题：当数据库密码中包含特殊字符（如@符号）时，会导致连接URI解析失败，出现"URI Parse Failed"错误。这是因为在MySQL连接字符串中，@符号不仅可能出现在密码中，还用于分隔密码和主机地址部分。

问题分析

MySQL连接URL的标准格式为：

mysql://username:password@host:port/database

当密码中包含@符号时，例如密码为"R00t@xxx2018"，原始连接字符串会变成：

mysql://root:R00t@xxx2018@127.0.0.1:3306/db

这会导致URL解析器无法正确识别密码和主机地址的分界，因为出现了两个@符号。

解决方案

Workflow项目提供了StringUtil::url_encode_component()方法来解决这个问题。正确的做法是对密码部分单独进行URL编码，而不是对整个连接字符串编码。

错误做法：

std::string url_b = "mysql://root:R00t@xxx2018@127.0.0.1:3306";
std::string url_f = StringUtil::url_encode_component(url_b);  // 错误：对整个URL编码

正确做法：

std::string url_f = "mysql://root:" + StringUtil::url_encode_component("R00t@xxx2018") + "@127.0.0.1:3306";

这样处理后，@符号会被正确编码为%40，解析器就能正确识别URL的各个部分。

连接管理机制

Workflow项目中的MySQL连接默认使用长连接机制，类似于HTTP连接。这意味着：

1. 同一个server的多个请求会复用连接，不需要每次都建立新连接
2. 默认最大连接数为200（对单个server）
3. 对于事务性操作或PREPARE语句，需要使用WFMySQLConnection确保多个请求在同一连接上执行

高级应用场景

在实际开发中，可能会遇到需要执行多个SQL操作的场景，例如：

1. 先查询记录是否存在
2. 如果不存在则插入
3. 插入完成后再更新其他表

对于这类场景：

• 如果没有严格的原子性要求，可以直接使用WFTaskFactory创建多个任务
• 如果需要事务支持（所有操作要么全部成功，要么全部失败），则需要使用WFMySQLConnection

性能优化建议

对于高并发场景，可以考虑使用Workflow的资源池(Resource Pool)功能来管理数据库连接：

1. 可以限制最大连接数
2. 当连接数达到上限时，新请求会排队等待而不是失败
3. 资源池管理不占用额外线程，效率高

常见问题排查

开发者在使用过程中可能会遇到以下问题：

1. SELECT查询回调不执行：这通常不是SQL语句本身的问题，Workflow对所有SQL操作（包括SELECT）都会执行回调。建议检查任务状态和错误信息。
2. 连接数异常增长：检查是否修改了默认连接数限制，或考虑使用资源池管理。
3. 事务处理异常：确保使用WFMySQLConnection进行事务操作。

通过正确理解和使用Workflow的MySQL连接机制，开发者可以构建高效、稳定的数据库应用。