Python处理包含带@等特殊字符的密码

原创已于 2026-03-19 16:54:26 修改 · 311 阅读

5 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#python #开发语言

于 2026-03-19 15:02:20 首次发布

玩转Python 专栏收录该内容

24 篇文章

订阅专栏

在Python中，连接数据库密码中包含特殊字符（如@、#、$等）时，常常会遇到令人头疼的连接问题。特别是@符号，它在连接字符串中扮演着分隔用户、密码和服务器的重要角色，一旦密码中包含这个字符，就会导致URL解析器产生混淆，将密码中的@误认为是新的分隔符，从而引发连接失败。下面就以SQL Server和MySQL为例，详细探究这一问题！

问题描述

明明密码正确，却因为包含@符号而导致"Login failed for user"或"Invalid connection string"等错误。

原因分析

当密码中包含@符号时，URL解析会将其误认为是主机名和数据库之间的分隔符。

例如：

# 错误的写法
engine_string = "mysql+pymysql://user:pass@word123@localhost/testdb"
engine_string = 'mssql+pymssql://user:pass@word123@localhost:1433/testdb?charset=utf8'
# 解析器会将第一个@后面的部分都当作主机名

解决方案

1. URL编码特殊字符（推荐）

使用urllib.parse.quote()对密码进行编码，构建连接字符串：

from urllib.parse import quote

password = "pass@word123"
encoded_password = quote(password, safe='')  # 编码所有特殊字符

# 使用pymysql连接MySQL
database_url = f"mysql://user:{encoded_password}@localhost/testdb"
print(database_url)
# 输出: mysql://user:pass%40word123@localhost/dbname

# 使用pymssql连接Sql Server
engine = create_engine(
    f"mssql+pymssql://{username}:{password}@{server}/{database}"
)
engine = create_engine(connection_string)

# 使用pyodbc连接Sql Server
encoded_password = quote(password, safe='')
connection_string = f"mssql+pyodbc://{username}:{encoded_password}@{server}/{database}?driver=ODBC+Driver+17+for+SQL+Server"
engine = create_engine(connection_string)

# 使用pyodbc连接Sql Server，也可以这样：
# 注意：ODBC连接字符串中需要使用花括号或转义
conn_str = f'DRIVER={{ODBC Driver 17 for SQL Server}};SERVER=localhost;DATABASE=testdb;UID=sa;PWD={{{password}}}'
conn = pyodbc.connect(conn_str)

2. 使用参数传递

避免在URL中包含密码，而是直接传递密码参数，避免URL解析问题：

# 使用pymysql连接MySQL
conn = pymysql.connect(
    host='localhost',
    user='user',
    password='pass@word123',  # 直接传递原始密码
    database='testdb'
)

# 使用pymssql连接Sql Server
conn = pymssql.connect(
    server='localhost',
    user='user',
    password='pass@word123',  # 直接使用原始密码
    database='testdb',
    port=1433
)

# 使用pyodbc连接Sql Server
conn = pyodbc.connect(
    driver='{ODBC Driver 17 for SQL Server}',
    server='localhost',
    database='testdb',
    uid='user',
    pwd='pass@word123'  # 直接传递原始密码
)

3. 使用环境变量

将密码存储在环境变量中：

import os
import pymssql
from urllib.parse import urlparse
from dotenv import load_dotenv

# 使用mysql设置环境变量
os.environ['DB_PASSWORD'] = 'pass@word123'
password = os.getenv('DB_PASSWORD')
database_url = f"mysql://user:{quote(password)}@localhost/dbname"

# 使用mysql设置环境变量
load_dotenv()
password = os.getenv('SQL_PASSWORD', 'pass@word123')
conn = pymssql.connect(
    server=os.getenv('SQL_SERVER', 'localhost'),
    user=os.getenv('SQL_USER', 'sa'),
    password=password,
    database=os.getenv('SQL_DATABASE', 'testdb')
)
# 其中.env文件内容：
# SQL_PASSWORD=pass@word123
# SQL_SERVER=localhost
# SQL_USER=sa
# SQL_DATABASE=testdb

4. 配置文件方式

使用配置文件（如.env文件）存储敏感信息：

# 使用.env 配置文件
# .env 文件
import os
from dotenv import load_dotenvx
DB_PASSWORD=pass@word123

load_dotenv()
password = os.getenv('DB_PASSWORD')
# 继续使用password...

# 使用config.py 配置文件
# config.py
class Config:
    SQL_SERVER = 'localhost'
    SQL_USER = 'sa'
    SQL_PASSWORD = 'pass@word123'  # 实际项目中应从环境变量读取
    SQL_DATABASE = 'testdb'
    SQL_PORT = 1433

# main.py
import pymssql
from config import Config

conn = pymssql.connect(
    server=Config.SQL_SERVER,
    user=Config.SQL_USER,
    password=Config.SQL_PASSWORD,
    database=Config.SQL_DATABASE,
    port=Config.SQL_PORT
)

5. SQLAlchemy特殊处理

如果使用SQLAlchemy：

from sqlalchemy import create_engine
from urllib.parse import quote

# 连接参数
server = 'localhost'
database = 'testdb'
username = 'sa'
password = 'pass@word123'

# 使用pymssql连接SQL Server（推荐，不需要编码）
encoded_password = quote(password, safe='')
engine = create_engine(
    f"mssql+pymssql://{username}:{password}@{server}/{database}"
)

# 使用pyodbc连接SQL Server（需要处理密码）
encoded_password = quote(password, safe='')
connection_string = f"mssql+pyodbc://{username}:{encoded_password}@{server}/{database}?driver=ODBC+Driver+17+for+SQL+Server"
engine = create_engine(connection_string)

# 使用pymysql连接MySQL
engine = create_engine(
    f"mysql+pymysql://user:{encoded_password}@localhost/dbname",
    pool_pre_ping=True
)

6. 原始字符串处理

如果需要手动处理：

def encode_password(password):
    """手动编码密码中的特殊字符"""
    special_chars = {
        '@': '%40',
        '#': '%23',
        '$': '%24',
        '%': '%25',
        '&': '%26',
        '+': '%2B',
        '/': '%2F',
        '?': '%3F',
        '=': '%3D'
    }
    for char, encoded in special_chars.items():
        password = password.replace(char, encoded)
    return password

password = "pass@word123"
encoded = encode_password(password)
print(encoded)  # 输出: pass%40word123

7. Windows认证连接

如果使用Windows认证，可以避免密码问题：

import pymssql
import pyodbc

# pymssql Windows认证
conn = pymssql.connect(
    server='localhost',
    database='testdb',
    trusted_connection='yes'  # 使用Windows认证
)

# pyodbc Windows认证
conn = pyodbc.connect(
    'DRIVER={ODBC Driver 17 for SQL Server};'
    'SERVER=localhost;'
    'DATABASE=testdb;'
    'Trusted_Connection=yes;'
)