如何在Tomcat 8 Java应用中正确获取图片文件的访问路径？

两段代码读不到图片，本质是没搞懂Tomcat运行时的两套路径解析规则：

• src/main/webapp/是Web应用打包阶段的源码目录，既不属于JVM类加载器的搜索范围，也不是Tomcat运行时解析文件相对路径的基准目录。
• 第一段getResourceAsStream()是类加载器API，默认仅会从编译后的类路径（即WEB-INF/classes、应用依赖的Jar包内部）搜索资源，完全不会扫描webapp下的静态目录。
• 第二段FileDataSource的相对路径，基准是Tomcat进程启动时的工作目录，和Web应用的部署目录没有绑定关系，自然无法定位到你写的StaticContent/images/image.png。

方案1：用类加载器读取资源（适配第一段图片读取代码） #

把图片移动到类加载器可扫描的目录下，不要留在webapp源码目录：

• 对Maven/Gradle构建的项目，直接将图片放到src/main/resources/StaticContent/images/image.png，构建流程会自动把该目录下的所有文件同步到运行时的WEB-INF/classes/路径下。
• 调用getResourceAsStream()时，路径必须加前导斜杠，否则会自动拼接当前类所在的包路径，修改后的代码：

InputStream in = getClass().getResourceAsStream("/StaticContent/images/image.png");
image = ImageIO.read(in);

漏写前导斜杠是最高发的踩坑点：比如你的业务类在com.example.service包下，不加斜杠时，类加载器会自动去com/example/service/StaticContent/images/image.png找文件，和你实际放资源的位置完全不匹配。

方案2：保留webapp下的图片存放位置（适配第二段FileDataSource代码） #

如果不想移动现有图片的位置，不能直接写相对路径，必须通过Servlet上下文拿到文件在磁盘上的真实绝对路径：

• 在能获取到ServletContext的组件（比如Servlet、过滤器、监听器）里，调用getRealPath()方法映射web路径到磁盘绝对路径：

// 以Servlet子类为例，直接调用父类方法获取Servlet上下文
ServletContext context = this.getServletContext();
String imageAbsolutePath = context.getRealPath("/StaticContent/images/image.png");
// 拿到绝对路径后再创建FileDataSource
DataSource fds_image = new FileDataSource(imageAbsolutePath);

注意：如果你的应用是以未解压的War包形式直接部署运行，getRealPath()会返回null，此时必须改用类加载器的方式读取资源，不能直接按磁盘文件访问。

• 不要依赖Tomcat的启动工作目录写相对路径，Tomcat从哪个目录启动、用什么脚本启动，工作目录就指向哪里，路径完全不可控。
• 现有异常处理代码里System.out.print(e.getStackTrace())是完全无效的：getStackTrace()返回栈帧对象数组，直接打印只会输出对象的哈希地址，根本看不到实际报错，要改成e.printStackTrace()或者通过日志框架记录异常，才能第一时间定位路径不存在的问题。

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