本文详解 Telethon 在 Ubuntu 服务器上因会话路径配置不当导致 sqlite3.OperationalError: unable to open database file 的根本原因，并提供可立即生效的修复方案，涵盖路径规范、权限适配与健壮性增强实践。
本文详解 telethon 在 ubuntu 服务器上因会话路径配置不当导致 `sqlite3.operationalerror: unable to open database file` 的根本原因，并提供可立即生效的修复方案，涵盖路径规范、权限适配与健壮性增强实践。
Telethon 默认使用 SQLite 存储会话数据（如授权状态、密钥、对话缓存等），其会话参数（session_name）不仅决定会话标识，更直接作为 SQLite 数据库文件的相对或绝对路径。在你的代码中：
session_name = "sessions/Bot" client = TelegramClient(session_name, API_ID, API_HASH).start(bot_token=BOT_TOKEN)
Telethon 将尝试在当前工作目录下创建并访问 sessions/Bot.session 文件（注意：.session 后缀由 Telethon 自动添加）。但问题在于：sessions/ 目录并不存在 —— 即使 database.db 和 config.ini 能被读取，TelegramClient 初始化时会立即尝试连接该路径下的 SQLite 文件，而 Python 的 sqlite3.connect() 在父目录不存在时将直接抛出 OperationalError: unable to open database file，且不提供更明确的“目录不存在”提示。
这正是本地开发环境与 Ubuntu 服务器行为差异的根源：
- 本地运行时，你可能在项目根目录执行 python script.py，当前工作目录即 /path/to/project/，此时 sessions/ 若已存在则无误；
- 但在服务器上，若以 root 用户通过 systemd、cron 或直接调用 /usr/local/bin/project/script.py 启动，当前工作目录极大概率是 /root 或 /，而非 /usr/local/bin/project/ —— 导致 sessions/Bot.session 被解析为 /root/sessions/Bot.session 或 /sessions/Bot.session，而这些路径既无写入权限，也无 sessions 目录。
✅ 正确解决方案（推荐两种方式）
方案一：使用绝对路径 + 自动创建目录（最健壮）
修改 session_name 为基于项目目录的绝对路径，并确保父目录存在：
import os # 获取 script.py 所在目录（推荐：避免依赖当前工作目录） PROJECT_DIR = os.path.dirname(os.path.abspath(__file__)) SESSION_PATH = os.path.join(PROJECT_DIR, "sessions", "Bot") # 确保 sessions 目录存在 os.makedirs(os.path.dirname(SESSION_PATH), exist_ok=True) client = TelegramClient(SESSION_PATH, API_ID, API_HASH).start(bot_token=BOT_TOKEN)
✅ 优势：完全解耦工作目录，路径明确可控；exist_ok=True 避免重复创建异常。
方案二：简化会话名（快速修复）
若无需自定义会话子目录，直接使用纯文件名：
session_name = "Bot" # Telethon 将在当前工作目录创建 Bot.session
⚠️ 注意：此方案仍需确保启动时的工作目录正确。建议配合 cd /usr/local/bin/project && python script.py 使用，或在脚本开头强制切换：
import os os.chdir(os.path.dirname(os.path.abspath(__file__)))
? 权限与安全补充说明
你提供的文件权限（如 database.db 为 -rw-rw-rw-）虽可读写，但存在安全隐患：
- root 用户拥有全部文件，但 Telethon 会话文件含敏感密钥，不应赋予组/其他用户写权限；
- 更佳实践：设为 600（仅所有者读写）：
chmod 600 /usr/local/bin/project/database.db chmod 600 /usr/local/bin/project/config.ini
- 若使用 sessions/ 目录，同样设置：
chmod 700 /usr/local/bin/project/sessions
? 验证与调试技巧
- 启动前打印实际会话路径，确认是否符合预期：
print(f"Session will be stored at: {SESSION_PATH}.session") - 检查 SQLite 文件是否成功生成：
ls -la /usr/local/bin/project/sessions/ # 应看到 Bot.session 文件（大小 > 0）
? 总结
unable to open database file 在 Telethon 中几乎总是路径问题，而非数据库损坏或权限不足（除非目录不可写）。核心原则是：永远显式管理会话路径，拒绝隐式相对路径依赖。采用 os.path.abspath(__file__) 定位项目根目录，再构建绝对路径，是跨平台、跨部署场景下最可靠的做法。同时，结合最小权限原则配置文件系统权限，兼顾功能与安全。
至此，你的 Telegram Bot 将在 Ubuntu 服务器上稳定持久化会话，不再因路径歧义中断初始化流程。
