Java Slack Bolt应用无法读取.env文件环境变量解决方法

问题原因 #

io.github.cdimascio:java-dotenv 默认仅将.env中的键值对加载到自身实例中，不会自动写入JVM进程的系统环境变量。Slack Bolt 无参App()构造器默认从System.getenv()读取SLACK_BOT_TOKEN、SLACK_SIGNING_SECRET两个配置，自然无法获取Dotenv实例内存储的值，最终因签名校验不通过返回unauthorized access错误。

解决方法 #

方法1：显式传入配置（推荐，逻辑可控无兼容问题）

放弃无参App()构造器，手动构建AppConfig对象，将Dotenv读取到的密钥直接传入配置，完全绕开默认的环境变量读取逻辑，修改后的代码如下：

package hello;
import com.slack.api.bolt.App;
import com.slack.api.bolt.AppConfig;
import com.slack.api.bolt.jetty.SlackAppServer;
import io.github.cdimascio.dotenv.Dotenv;

public class MyApp {
    public static void main(String[] args) throws Exception
    {
        Dotenv dotenv = Dotenv.configure()
                .directory("./")
                .ignoreIfMissing() // 生产环境无.env文件时不报错，可选配置
                .load();

        // 手动构建Slack应用配置，直接传入读取到的密钥
        AppConfig config = AppConfig.builder()
                .singleTeamBotToken(dotenv.get("SLACK_BOT_TOKEN"))
                .signingSecret(dotenv.get("SLACK_SIGNING_SECRET"))
                .build();

        App slackApp = new App(config);
        slackApp.command("/mytesthello", (req, ctx)-> {
            return ctx.ack(":wave: Hello!");
        });

        SlackAppServer slackAppServer = new SlackAppServer(slackApp);
        slackAppServer.start();
    }
}

方法2：开启Dotenv系统属性注入

如果不想修改App初始化逻辑，可以在Dotenv初始化时开启systemProperties选项，加载的键值对会自动写入JVM系统属性。Slack Bolt默认配置加载逻辑会同时读取系统环境变量和JVM系统属性，也能正常获取配置：

Dotenv dotenv = Dotenv.configure()
        .directory("./")
        .ignoreIfMissing()
        .systemProperties() // 将加载到的变量注入System.getProperties()
        .load();
// 后续直接使用new App()即可，无需额外传参
App slackApp = new App();

注意：该方法依赖Slack Bolt的配置加载优先级，若后续SDK版本修改配置读取规则可能失效，优先选择方法1。

配置注意事项 #

• 确保.env文件放在执行mvn命令的项目根目录下，如果存放在src/main/resources目录，需要将Dotenv的directory参数修改为对应路径
• .env文件中的配置值不要加多余的引号，正确写法为SLACK_BOT_TOKEN=xoxb-xxx，不要写成SLACK_BOT_TOKEN="xoxb-xxx"，避免读取到带引号的无效密钥
• 务必将.env加入.gitignore规则，防止密钥被提交到公开代码仓库

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