Heroku部署Discord JDA（Maven）Bot成功但无法运行，求排查方案

我来帮你梳理一下可能导致这个问题的常见操作失误，同时也分享一下其他开发者遇到过的类似情况：

1. Procfile配置踩坑 #

Heroku完全靠Procfile来识别启动命令，对于Maven构建的JDA Bot，这里最容易出错：

• 必须指定worker进程类型：Discord Bot不需要监听HTTP端口，要是用了默认的web进程，Heroku会因为检测不到端口监听直接终止进程；
• 命令里的Jar路径要准确：通常Maven打包后的可执行Jar是target/<你的项目名>-<版本号>-jar-with-dependencies.jar，别写错成普通Jar（不带依赖的那种运行起来会缺类）；
• 别拼错文件名：是Procfile（首字母大写，没有后缀），写成Profile或者加了.txt后缀都会失效。

2. Maven打包没配置全 #

JDA Bot需要把所有依赖打包进一个可执行Jar里，很多人会漏掉这个配置：

• 一定要在pom.xml里添加打包插件，比如maven-shade-plugin或者maven-assembly-plugin，不然生成的Jar只有自己的代码，运行时会抛出ClassNotFoundException；
• 示例配置（maven-shade-plugin）：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-shade-plugin</artifactId>
            <version>3.2.4</version>
            <executions>
                <execution>
                    <phase>package</phase>
                    <goals>
                        <goal>shade</goal>
                    </goals>
                    <configuration>
                        <transformers>
                            <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
                                <mainClass>你的主类全路径，比如com.yourbot.Main</mainClass>
                            </transformer>
                        </transformers>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
</build>

• 先在本地跑mvn package，然后用java -jar target/xxx.jar测试能不能正常启动，排除本地打包问题。

3. 环境变量没配置对 #

Discord Token绝对不能硬编码，而且很多人会忘在Heroku里配置：

• 去Heroku应用的「设置」页面，找到「Config Vars」，添加DISCORD_TOKEN变量，值填你的Bot Token；
• 代码里要改成读取环境变量：System.getenv("DISCORD_TOKEN")，要是没配置这个，Bot启动时会因为Token无效直接崩溃。

4. Heroku资源没开起来 #

部署成功不代表进程在运行：

• 去Heroku应用的「资源」页面，检查worker进程是不是处于「启用」状态，默认有时候是关闭的，需要手动点开；
• 免费dyno会30分钟休眠，但刚部署就不能用肯定不是这个问题，先排查前面的点。

5. 没看日志等于瞎猜 #

Heroku的日志里藏着所有答案：

• 用命令行跑heroku logs --tail实时看日志，或者在Dashboard的「日志」页面查看；
• 常见错误比如：找不到主类、缺依赖、Token无效、网络连不上Discord API，日志里都会写得明明白白。

很多开发者在社区里都踩过这些坑：

• 有人用了web进程类型，导致Heroku强制要求端口监听，Bot进程直接被kill；
• 有人没配置打包插件，生成的Jar缺JDA依赖，运行时一堆类找不到；
• 还有人忘加环境变量，日志里全是「Invalid Token」的报错，自己却没注意看。

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