Spring Boot/MVC：如何提供含特殊字符的JAR外部静态文件？

嘿，我看你正在配置Spring MVC来访问JAR包外部的静态文件，这段代码我帮你补全并梳理下关键要点：

完整可运行的配置代码 #

@Configuration
@ComponentScan({"some.package"})
public class MaboConfiguration extends WebMvcConfigurerAdapter {

    /* 省略无关配置 */

    @Value("${application.pdfpath}")
    public String pdfPath;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 映射URL路径 /files/** 到外部文件系统的指定目录
        registry.addResourceHandler("/files/**")
                // 注意这里要给路径加上末尾的斜杠，避免拼接资源名时出错
                .addResourceLocations("file:" + this.pdfPath + "/");
    }
}

必须注意的几个细节 #

• 路径格式要严谨：不管你的application.pdfpath配置的是Windows路径（比如D:/my-pdfs/）还是Linux路径（比如/opt/app/pdf-files/），一定要确保路径末尾带斜杠，或者在代码里手动加上。不然会出现类似/opt/app/pdf-filesmyfile.pdf这种错误的路径。
• 绝对路径是前提：file:前缀指定了使用文件系统的绝对路径，所以application.pdfpath不能填相对路径，必须是完整的系统路径。
• 权限不能忘：要保证运行你的应用的进程有访问这个目录的读权限，不然即使配置对了也会返回404或者权限拒绝的错误。
• 版本兼容提醒：如果你的Spring版本是5.x及以上，建议换成实现WebMvcConfigurer接口（WebMvcConfigurerAdapter已经被废弃了），代码逻辑完全一样，只是把继承改成实现接口就行。

额外的小优化 #

把路径配置写到application.properties里，后续改路径不用动代码：

# application.properties
application.pdfpath=/opt/app/external-static-files/

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