本文详解 PythonAnywhere 部署 Telegram Bot 时因相对路径错误导致 KeyError: 'ADMINS' 的根本原因与解决方案，重点讲解配置文件路径适配、工作目录处理及健壮性增强技巧。
本文详解 pythonanywhere 部署 telegram bot 时因相对路径错误导致 `keyerror: 'admins'` 的根本原因与解决方案，重点讲解配置文件路径适配、工作目录处理及健壮性增强技巧。
在 PythonAnywhere 上部署 Telegram Bot 时，最常见的失败原因之一是路径解析不一致——本地开发环境（如 Windows + VS Code）中相对路径往往基于项目根目录或 IDE 工作区自动解析，而 PythonAnywhere 的 Web/Task 运行环境默认工作目录并非你的项目文件夹，而是用户主目录（/home/username/），导致 open("config.json") 实际尝试在 /home/username/config.json 查找文件，而非你期望的 /home/username/mybot/config.json。
你原代码中：
CONFIG_FILE = "%Project_name%/config.json"
不仅使用了占位符（未被替换），更关键的是该路径是相对于当前工作目录（CWD） 的相对路径，而非相对于脚本所在目录。PythonAnywhere 启动 bot 时 CWD 通常不是你的项目目录，因此 os.path.exists(CONFIG_FILE) 返回 False，load_config() 返回空字典 {}，进而引发 config["ADMINS"] 的 KeyError。
✅ 正确做法是：始终基于当前 Python 文件的位置（__file__）构建绝对路径，确保配置文件定位与运行位置解耦。推荐重构 load_config() 如下：
立即学习“Python免费学习笔记（深入）”；
import os
import json
# 获取当前脚本所在目录（即 bot.py 所在文件夹）
BASE_DIR = os.path.dirname(os.path.abspath(__file__))
CONFIG_FILE = os.path.join(BASE_DIR, "config.json")
DATA_FILE = os.path.join(BASE_DIR, "user_data.json")
def load_config():
if not os.path.exists(CONFIG_FILE):
raise FileNotFoundError(f"Config file not found: {CONFIG_FILE}")
try:
with open(CONFIG_FILE, 'r', encoding='utf-8') as f:
return json.load(f)
except json.JSONDecodeError as e:
raise ValueError(f"Invalid JSON in {CONFIG_FILE}: {e}")
def load_user_data():
if not os.path.exists(DATA_FILE):
return {}
with open(DATA_FILE, 'r', encoding='utf-8') as f:
return json.load(f)? 关键改进说明：
-
os.path.dirname(os.path.abspath(__file__))精准获取bot.py所在目录，不受cd或启动方式影响； - 使用
os.path.join()构建跨平台安全路径； - 增加异常提示（如文件不存在、JSON 格式错误），便于 PythonAnywhere 日志排查；
- 避免空返回
{}导致静默失败，改用显式报错更利于调试。
⚠️ 注意事项：
- 在 PythonAnywhere 的 Web tab 中，确保 “Code” 框内填写的
Working directory设置为你的项目路径（如/home/username/mybot）； - 若使用 Tasks tab 运行定时任务（如轮询 bot），需在命令前显式
cd到项目目录，例如：cd /home/username/mybot && python3 bot.py -
config.json和user_data.json必须通过 PythonAnywhere 的 Files 页面或bash终端上传至项目目录（与bot.py同级），并确认文件权限为可读（通常默认即可）； - 不建议依赖环境变量临时修改
os.getcwd()，因其不可靠且易被覆盖。
通过以上路径重构，你的 Bot 将在任何环境（本地、PA、Docker）中稳定加载配置，彻底规避 KeyError: 'ADMINS' 类错误。部署后，务必查看 PythonAnywhere 的 Error log 和 Server log，验证配置是否成功加载。
