Python3.9编写的Discord游戏服务器统计Bot启动报KeyError: 'TOKEN'错如何解决

你在代码中通过os.environ['TOKEN']尝试读取运行环境中名为TOKEN的环境变量，但当前启动Bot的运行环境未配置该环境变量，因此操作系统模块直接抛出KeyError。

1. 临时配置环境变量（适合本地临时测试） #

根据你使用的终端类型，先执行对应配置命令再启动Bot即可：

• Windows CMD：执行set TOKEN=你的Discord Bot实际令牌
• Windows PowerShell：执行$env:TOKEN = "你的Discord Bot实际令牌"
• Linux/macOS 终端：执行export TOKEN=你的Discord Bot实际令牌

2. 本地开发持久化配置（推荐常规开发使用） #

通过.env文件管理私密配置，避免每次启动重复输入：

• 首先安装依赖包：pip install python-dotenv
• 在项目根目录新建名为.env的文件，写入内容：TOKEN=你的Discord Bot实际令牌（前后不要留空格、不要加多余引号）
• 在main.py文件中读取os.environ['TOKEN']的代码之前，添加以下两行代码，自动加载.env文件的配置：

from dotenv import load_dotenv
load_dotenv()

注意：请务必将.env文件加入.gitignore规则，避免误提交到公开代码仓库导致Bot令牌泄露。

3. Docker运行场景配置 #

从你的报错路径来看项目包含Docker配置，可按以下方式配置：

• 直接运行容器时添加环境变量参数：docker run -e TOKEN=你的Discord Bot实际令牌 你的镜像名称
• 若使用docker-compose部署，在对应服务的配置段添加环境变量声明即可：

services:
  your-bot-service-name:
    # 其余原有配置保持不变
    environment:
      - TOKEN=你的Discord Bot实际令牌

4. 代码兜底优化 #

可以修改读取环境变量的代码，避免直接抛出无意义的KeyError，给出更明确的提示：

import os
BOT_TOKEN = os.environ.get('TOKEN')
if not BOT_TOKEN:
    raise ValueError("未读取到有效TOKEN，请先配置对应环境变量后再启动Bot")

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