SparkJava部署WAR包时浏览器下载HTML而非显示问题排查

我之前碰到过类似的情况，结合你用的SparkJava框架代码来看，核心问题大概率是WAR包运行模式下静态资源的MIME类型未正确映射，或者打包后的资源路径处理和本地IDE环境有差异。下面给你几个针对性的解决办法：

1. 显式配置MIME类型映射 #

Spark在本地IDE内嵌Jetty运行时，会自动识别常见文件的MIME类型，但打包成WAR后可能丢失这个默认配置。你可以在main方法里手动添加HTML的MIME映射，确保浏览器能正确解析：

public static void main(String[] args) { 
    ProcessBuilder process = new ProcessBuilder(); 
    Integer port; 
    if (process.environment().get("PORT") != null) { 
        port = Integer.parseInt(process.environment().get("PORT")); 
    } else { 
        port = 4567; 
    } 
    port(port); 
    // 新增：强制将html文件映射为text/html类型
    mimeTypes().put("html", "text/html");
    staticFileLocation("/public"); 
} 

2. 验证WAR包的资源结构 #

打包后要确保public文件夹被正确放到WEB-INF/classes目录下（Maven/Gradle默认会把src/main/resources下的内容打包到这里）。你可以解压WAR包检查：

• 正确的结构应该是：project.war/WEB-INF/classes/public/index.html
  如果路径不对，需要调整打包配置，比如Maven的pom.xml里确保resources目录被完整包含：

<build>
    <resources>
        <resource>
            <directory>src/main/resources</directory>
            <includes>
                <include>**/*</include>
            </includes>
        </resource>
    </resources>
</build>

3. 手动添加根路径路由（兜底方案） #

如果上面的方法无效，可以直接给根路径/添加一个路由，显式返回index.html并指定Content-Type：

get("/", (request, response) -> {
    response.type("text/html");
    // 从类路径读取静态文件，适配WAR包的运行环境
    return new InputStreamReader(YourMainClass.class.getResourceAsStream("/public/index.html"));
});

记得把YourMainClass替换成你的主类名称。

额外排查点 #

• 检查你使用的Spark版本，某些旧版本在WAR打包模式下存在静态资源处理的bug，建议升级到最新稳定版。
• 如果是用java -jar运行WAR，确保你的WAR包是可执行的（Maven可以用war-exec插件打包生成可执行WAR）。

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