使用python-dotenv运行Slack Bolt Python项目遇授权错误求助

问题原因 #

你遇到的错误是因为python-dotenv加载的.env文件中存在额外的Slack OAuth相关环境变量（比如SLACK_CLIENT_ID、SLACK_CLIENT_SECRET），导致Slack Bolt自动切换到OAuth授权模式——此时你传入的token参数会被忽略。而你没有配置对应的installation_store来存储授权信息，所以出现了找不到授权结果的错误。

当你用export方式设置变量时，只传入了SLACK_BOT_TOKEN和SLACK_APP_TOKEN，Bolt会使用单工作区模式直接调用传入的token，所以能正常运行。

解决方案 #

方案1：单工作区场景（推荐） #

如果你的Bot只需要在单个工作区使用，确保.env文件中只保留以下两个变量，删除其他所有Slack相关的环境变量：

SLACK_BOT_TOKEN=xoxb-xxx-xxx
SLACK_APP_TOKEN=xapp-xxx-xxx

保持原代码不变，load_dotenv()就能正常加载变量，Bolt会使用单工作区模式，不会触发授权错误。

方案2：多工作区OAuth场景 #

如果需要支持多工作区，你需要配置installation_store来存储授权信息，修改代码如下：

import os
from dotenv import load_dotenv
from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler
from slack_bolt.memory_storage import MemoryInstallationStore
from slack_bolt.oauth.oauth_settings import OAuthSettings

load_dotenv()

# 配置OAuth和安装存储（Memory仅用于测试，生产环境请用数据库存储）
oauth_settings = OAuthSettings(
    client_id=os.environ.get("SLACK_CLIENT_ID"),
    client_secret=os.environ.get("SLACK_CLIENT_SECRET"),
    installation_store=MemoryInstallationStore(),
)

app = App(oauth_settings=oauth_settings)

@app.message("hello")
def message_hello(message, say):
    say(f"Hey there <@{message['user']}>!")

if __name__ == "__main__":
    SocketModeHandler(app, os.environ["SLACK_APP_TOKEN"]).start()

注意：MemoryInstallationStore重启后会丢失数据，生产环境建议使用Redis、PostgreSQL等持久化存储。

额外排查点 #

• 确认.env文件路径是否正确：如果你的.env不在当前脚本目录，需要指定路径，比如load_dotenv(dotenv_path="/path/to/your/.env")
• 检查.env中的变量名是否拼写正确，比如SLACK_BOT_TOKEN不要写成SLACK_BOT_TOKENS

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