python sqlalchemy操作mysql密码包含@特殊字符报错的解决方案

遇到的问题

  使用python3.x的sqlalchemy操作数据库，在windows环境运行正常，部署到linux服务器上以后，出现无法运行的情况，而且问题必现。

报错内容如下：

python3 db_test.py 
mysql+pymysql://root:xxxx@[email protected]:3306/robot?charset=utf8
查询失败  (pymysql.err.OperationalError) (2003, "Can't connect to MySQL server on '[email protected]' ([Errno -2] Name or service not known)")
(Background on this error at: http://sqlalche.me/e/14/e3q8)
select_calls_detail_not_complete_list(2021-09-10 14:53:31.313293, 2021-09-10 14:54:31.313313)

  看描述应该是@符号导致的解析问题。

原始代码如下：

from sqlalchemy import create_engine

userName = 'root'
password = 'xxxx@163'
dbHost = '127.0.0.1'
dbPort = 3306
dbName = 'robot'

DB_CONNECT = f'mysql+pymysql://{userName}:{password}@{dbHost}:{dbPort}/{dbName}?charset=utf8'

engine = create_engine(
        DB_CONNECT,
        max_overflow=50,  # 超过连接池大小外最多创建的连接
        pool_size=50,  # 连接池大小
        pool_timeout=5,  # 池中没有线程最多等待的时间，否则报错
        pool_recycle=-1,  # 多久之后对线程池中的线程进行一次连接的回收（重置）
        encoding='utf-8',
        echo=False
    )

解决方案

  由于怀疑是密码解析问题，所以对密码进行编码处理的尝试。

  使用了python的urllib库中提供了quote_plus编码方法，问题解决。

  代码如下：

from urllib.parse import quote_plus as urlquote

DB_CONNECT = f'mysql+pymysql://{userName}:{urlquote(password)}@{dbHost}:{dbPort}/{dbName}?charset=utf8'

知识扩展

下面简单介绍quote与quote_plus的区别：

urllib.quote(s, safe='/')

  接受参数s为字符串，safe是指定某字符不被urlencode，默认为’/’，如指定’+’、’/'不需转换，传 ‘+/’ 和 ‘+ /’ 均可，同时会将空格转换为%20。

  代码示例：

>>> urllib.quote(u'老王 /+'.encode('utf8'))
'%E8%80%81%E7%8E%8B%20/%2B'

urllib.quote_plus(s, safe='')

  此方法的源码为:

def quote_plus(s, safe=''):
    """Quote the query fragment of a URL; replacing ' ' with '+'"""
    if ' ' in s:
        s = quote(s, safe + ' ')
        return s.replace(' ', '+')
    return quote(s, safe)

  可以看出它比quote多一些功能，但是会将“空格”转换成“加号”，默认safe为空。

  代码示例：

>>> urllib.quote_plus(u'老王 /+'.encode('utf8'))
'%E8%80%81%E7%8E%8B+%2F%2B'