连接字符串编码问题怎么解

“连接字符串编码问题”通常出现在 数据库连接字符串（Connection String） 里包含 中文、特殊字符、空格、密码符号 等场景，导致连接失败或乱码。下面按常见情况给你一套解决思路。

一、最常见原因

1️⃣ 特殊字符未转义

如果密码或参数里有这些字符：

: / @ # ? & = + 空格

很容易被连接字符串解析器误认为分隔符。

✅ 解决：URL 编码（百分号编码）

示例（MySQL）：

jdbc:mysql://localhost:3306/test?user=root&password=pa%40ss%20word

2️⃣ 中文或乱码问题

连接字符串本身不包含中文最好，但：

• 数据库名、用户名是中文
• 客户端和服务端编码不一致

✅ 解决：

• 尽量避免中文
• 必须用时进行 URL 编码
• 明确指定字符集

MySQL 示例：

jdbc:mysql://localhost:3306/测试?useUnicode=true&characterEncoding=UTF-8

二、不同语言的常见处理方式

Java（JDBC）

String url = "jdbc:mysql://localhost:3306/db?useUnicode=true&characterEncoding=UTF-8";

密码含特殊字符：

String password = URLEncoder.encode("pa@ss word", "UTF-8");

Python

import urllib.parse

password = urllib.parse.quote("pa@ss word")
conn_str = f"mysql+pymysql://root:{password}@localhost/db"

.NET (C#)

Server=localhost;Database=test;User Id=root;Password=pa%40ss word;

或使用 SqlConnectionStringBuilder 自动处理编码。

三、配置文件中的坑

✅ 正确

db.password=pa%40ss%20word

❌ 错误

db.password=pa@ss word

YAML / JSON 同理，注意引号。

四、调试技巧

1. 打印最终连接字符串（脱敏）
2. 用数据库客户端手动连
3. 检查错误：
   • Access denied → 密码编码问题
   • Unknown database → 库名编码
   • 乱码 → 字符集不一致

五、通用最佳实践 ✅

• 密码避免 @ # & 空格
• 特殊字符一律 URL 编码
• 显式指定字符集（UTF-8）
• 用连接池 / Builder 类

如果你能告诉我：

• 使用的 数据库（MySQL / PostgreSQL / SQL Server / Oracle）
• 语言 / 框架
• 具体的 连接字符串或报错信息

我可以直接帮你改到可用 ✅