如何在 PythonAnywhere 上正确部署 Telegram Bot-Python教程-PHP中文网

如何在 PythonAnywhere 上正确部署 Telegram Bot

本文详解 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-code-analyz

专业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()，因其不可靠且易被覆盖。