我来帮你解决这个问题！你遇到的核心问题是用@RestController只处理了单个index.html文件，但没有覆盖所有静态资源的路径映射，而且Spring Boot默认只会从jar包内部的静态目录（比如classpath:/static/）加载资源，不会自动读取外部文件夹的内容。下面给你两种可行的解决方案，推荐第一种，更符合Spring Boot的设计风格：

方案一：配置静态资源映射（推荐） #

Spring Boot提供了现成的静态资源配置，你可以通过配置文件或者Java配置类，把外部文件夹映射为应用的静态资源目录，这样所有符合路径的请求都会自动从外部文件夹读取文件，无需手动写控制器。

方法1：使用配置文件（application.properties/application.yml） #

如果你希望外部文件夹/var/www/html/demo下的所有资源，通过http://localhost:8080/package/**访问（和你的应用上下文路径对应），可以在application.properties中添加：

# 保留Spring默认的静态资源目录，同时添加外部文件夹
spring.web.resources.static-locations=classpath:/META-INF/resources/,classpath:/resources/,classpath:/static/,classpath:/public/,file:/var/www/html/demo/

或者用YAML格式（application.yml）：

spring:
  web:
    resources:
      static-locations:
        - classpath:/META-INF/resources/
        - classpath:/resources/
        - classpath:/static/
        - classpath:/public/
        - file:/var/www/html/demo/

配置完成后，重启应用：

• 访问http://localhost:8080/package/index.html会直接加载/var/www/html/demo/index.html
• 访问http://localhost:8080/package/assets/js/config.js会加载/var/www/html/demo/assets/js/config.js
• 所有外部文件夹的资源更新后，无需重启应用，直接刷新浏览器就能看到变化。

方法2：使用Java配置类（更灵活） #

如果你想指定更精确的路径映射（比如只把/package/demo/**映射到外部文件夹），可以创建一个WebMvcConfigurer的实现类：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class StaticResourceConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射URL路径/demo/**到外部文件夹/var/www/html/demo/
        registry.addResourceHandler("/demo/**")
                .addResourceLocations("file:/var/www/html/demo/")
                // 允许浏览器缓存资源，可选，根据需求调整
                .setCachePeriod(0);
    }
}

这样配置后，访问http://localhost:8080/package/demo/index.html就会加载/var/www/html/demo/index.html，对应的资源路径http://localhost:8080/package/demo/assets/js/config.js也会正确指向外部文件。

方案二：改进控制器（不推荐，需手动处理细节） #

如果一定要用控制器来处理，你需要覆盖所有资源路径，并且返回正确的资源类型和响应头。之前的代码只处理了根路径，没有处理子路径，而且返回字符串会丢失文件的Content-Type，导致浏览器无法正确解析CSS/JS。改进后的代码如下：

import org.springframework.core.io.FileSystemResource;
import org.springframework.http.HttpHeaders;
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import java.io.File;
import java.nio.file.Path;
import java.nio.file.Paths;

@RestController
@RequestMapping("/demo")
public class DemoController {
    private static final String EXTERNAL_DIR = "/var/www/html/demo/";

    @GetMapping("/**")
    public ResponseEntity<FileSystemResource> handleResource(@PathVariable(required = false) String path) {
        // 处理根路径（访问/demo时返回index.html）
        if (path == null || path.isEmpty()) {
            path = "index.html";
        }
        Path filePath = Paths.get(EXTERNAL_DIR, path);
        File file = filePath.toFile();

        if (!file.exists() || !file.isFile()) {
            return new ResponseEntity<>(HttpStatus.NOT_FOUND);
        }

        // 设置正确的Content-Type，Spring会自动根据文件后缀推断
        HttpHeaders headers = new HttpHeaders();
        return new ResponseEntity<>(new FileSystemResource(file), headers, HttpStatus.OK);
    }
}

这种方式需要手动处理路径匹配、文件存在性检查、Content-Type设置等，不如方案一简洁，所以优先推荐方案一。

内容的提问来源于stack exchange，提问作者Bằng Rikimaru