Spark Java所有端点均返回404错误排查求助

以下是针对你遇到的「路由已配置但日志提示未映射」问题的排查方向和解决方法：

1. 端口映射不匹配 #

Spark默认监听4567端口，如果K8s的Service/Ingress配置的端口和容器内Spark端口不一致，请求会打错端口，导致路由找不到。

• 检查K8s Service的targetPort是否指向容器内Spark的监听端口（默认4567）；
• 若要修改Spark端口，在代码里显式指定：port(8080);，同时同步更新K8s容器端口和Service配置。

2. 路由注册时机错误 #

Spark的路由必须在Spark服务启动前完成注册，如果路由代码放在非主线程、或者服务启动后才执行，会导致路由未被加载。

• 确保所有get()/post()路由注册逻辑放在main方法最前面，再启动Spark：

public static void main(String[] args) {
    // 先注册路由
    get("/hello", (req, res) -> {
        res.status(200);
        res.type("text/plain");
        return "Hello, World!  This is DataPeddler v1";
    });
    // 再启动服务
    port(4567);
    init();
}

3. Ingress路径重写配置错误 #

如果用了K8s Ingress，路径重写规则错误会导致实际请求路径和注册的路由不匹配。

• 检查Ingress的nginx.ingress.kubernetes.io/rewrite-target注解，比如Ingress路径配置为/data-peddler/*，重写目标要设为/$1，这样/data-peddler/hello会转发到容器内的/hello。

4. 缺失上下文路径配置 #

如果应用通过子路径访问（比如http://xxx/app/hello），但Spark没配置上下文路径，会导致路由只匹配根路径下的/hello，无法匹配带前缀的请求。

• 给Spark设置上下文路径：path("/app");，这样注册的/hello会对应实际访问路径/app/hello。

5. Jar包打包异常 #

如果用fatJar/shadowJar打包，可能存在类未正确打包、类加载顺序错误的问题，导致路由注册代码未执行。

• 检查打包配置（Maven shade/Gradle shadowJar），确保主类和路由注册类都被正确包含；
• 启动Jar时显式指定主类：java -jar your-app.jar com.your.package.MainClass。

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