Alembic设置数据库URL时出现TypeError：选项值必须为字符串

核心问题：相对路径基准错误 #

你当前用的load_dotenv('./../.env')是基于执行alembic命令的工作目录，而非env.py文件所在目录。如果习惯在项目根目录执行alembic命令（比如alembic upgrade head），这个相对路径会指向项目根目录的上级，自然找不到.env文件。

解决方法：用绝对路径加载.env #

修改env.py中的加载逻辑，通过__file__获取当前文件的绝对路径，再拼接.env的位置，确保无论在哪执行命令都能正确找到文件：

from alembic import context
import os
from dotenv import load_dotenv

# 获取env.py所在目录的绝对路径，再拼接上级目录的.env
env_file_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), "../.env")
load_dotenv(env_file_path)

config = context.config
DATABASE_URL = os.environ.get("DATABASE_URL")

# 增加校验，确保变量加载成功
if not DATABASE_URL:
    raise ValueError("未读取到DATABASE_URL环境变量，请检查.env文件是否存在或配置正确")

# 去除URL可能存在的首尾空格
DATABASE_URL = DATABASE_URL.strip()
config.set_main_option('sqlalchemy.url', DATABASE_URL)

额外检查点 #

• 确认配置修改时机：要保证config.set_main_option在context.configure或engine_from_config之前执行，避免配置已被读取后再修改无效。
• 验证.env格式：确保.env中DATABASE_URL的等号前后无空格、无多余换行，比如DATABASE_URL=mysql+mysqldb://root:123321@localhost/MyDatabase。
• 驱动安装检查：确认已安装对应MySQL驱动，执行pip install mysqlclient（匹配mysql+mysqldb连接方式）。

内容的提问来源于stack exchange，提问作者William Le