导出Jar文件后动画纹理加载失败问题求助

问题核心原因 #

导出为Jar文件后，Jar内的资源目录并非文件系统中的真实文件夹，原代码中使用new File(getResource(folderPath).getFile())的方式无法访问Jar包内的目录，导致listFiles()返回null，触发IOException，最终因Animation实例为null引发NullPointerException。

解决方案 #

替换基于File类的资源读取方式，改用类加载器直接读取Jar内的资源流，通过枚举资源路径的方式获取动画帧文件。

需添加的导入语句 #

import java.util.Enumeration;
import java.util.ArrayList;
import java.util.Collections;
import java.util.List;
import java.net.URL;

修改后的TextureLibrary.java关键代码 #

/**
 * Get an animation by its ID.
 */
public static Animation getAnimation(int id, int frameTime) {
    if (!isAnimation.getOrDefault(id, false)) {
        throw new IllegalArgumentException("The texture ID does not correspond to an animation.");
    }

    String folderPath = texturePaths.get(id);
    if (folderPath == null) {
        throw new IllegalArgumentException("Invalid texture ID: " + id);
    }

    // 确保路径以"/"结尾，避免枚举时遗漏子资源
    if (!folderPath.endsWith("/")) {
        folderPath += "/";
    }

    try {
        // 枚举Jar内该目录下的所有PNG资源
        Enumeration<URL> resources = TextureLibrary.class.getClassLoader().getResources(folderPath);
        List<String> frameNames = new ArrayList<>();

        // 先收集所有帧文件名用于排序
        while (resources.hasMoreElements()) {
            URL url = resources.nextElement();
            String fileName = url.getFile();
            String frameName = fileName.substring(fileName.lastIndexOf("/") + 1);
            if (frameName.endsWith(".png")) {
                frameNames.add(frameName);
            }
        }

        if (frameNames.isEmpty()) {
            throw new IOException("No PNG frames found in animation folder: " + folderPath);
        }

        // 按文件名排序，保证动画帧顺序正确
        Collections.sort(frameNames);
        BufferedImage[] frames = new BufferedImage[frameNames.size()];

        // 按排序后的文件名加载帧
        for (int i = 0; i < frameNames.size(); i++) {
            String framePath = folderPath + frameNames.get(i);
            frames[i] = ImageIO.read(TextureLibrary.class.getClassLoader().getResourceAsStream(framePath));
        }

        return new Animation(frames, frameTime);
    } catch (IOException e) {
        e.printStackTrace();
        // 抛出异常避免返回null，防止后续NPE
        throw new RuntimeException("Failed to load animation: " + folderPath, e);
    }
}

额外优化点 #

1. 禁止返回null：将原方法的return null改为抛出RuntimeException，避免后续调用pause()等方法时触发NullPointerException。
2. 帧顺序保障：通过收集文件名并排序，确保动画帧按命名顺序加载（如frame1.png→frame2.png）。
3. 路径规范处理：自动为文件夹路径添加结尾的/，避免枚举资源时出现遗漏。

验证步骤 #

1. 重新导出Jar文件，确认assets/textures/map/player/furbee/下的所有帧文件都已正确打包进Jar。
2. 运行Jar文件，检查是否再出现文件夹读取失败的IOException。
3. 若仍有问题，检查帧文件名是否统一为.png后缀，且命名规则保证排序逻辑有效。

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