如何解决JLabel中GIF仅播放一次无法循环的问题？

这个问题其实挺常见的——Java自带的ImageIcon在处理GIF动画时，默认的播放逻辑有时候不会自动循环，尤其是当GIF播放完一轮后，内部的帧指针会停在最后一帧，不会主动重置。下面给你几种靠谱的解决办法：

方法一：自定义动画Icon（最推荐） #

直接写一个自定义的Icon类，手动控制GIF帧的循环播放，完全摆脱ImageIcon的限制。代码如下：

import javax.swing.*;
import java.awt.*;
import java.awt.image.*;

public class AnimatedGIFIcon extends ImageIcon implements Runnable {
    private volatile boolean isRunning = true;
    private int currentFrameIndex = 0;
    private Image[] frames;
    private int[] frameDelays;
    private Thread animationThread;

    public AnimatedGIFIcon(String filePath) {
        super(filePath);
        loadAllFrames();
    }

    private void loadAllFrames() {
        Image sourceImage = getImage();
        MediaTracker tracker = new MediaTracker(new JLabel());
        tracker.addImage(sourceImage, 0);
        
        try {
            tracker.waitForAll();
        } catch (InterruptedException e) {
            e.printStackTrace();
        }

        // 获取GIF的总帧数
        int totalFrames = ((Integer) sourceImage.getProperty("frameCount", null)).intValue();
        frames = new Image[totalFrames];
        frameDelays = new int[totalFrames];

        // 加载每一帧和对应的延迟时间
        for (int i = 0; i < totalFrames; i++) {
            frames[i] = sourceImage.getScaledInstance(getIconWidth(), getIconHeight(), Image.SCALE_DEFAULT);
            int delay = ((Integer) sourceImage.getProperty("delay" + i, null)).intValue();
            frameDelays[i] = delay <= 0 ? 100 : delay; // 给无效延迟设默认值
        }
    }

    @Override
    public void paintIcon(Component component, Graphics g, int x, int y) {
        g.drawImage(frames[currentFrameIndex], x, y, component);
    }

    @Override
    public void run() {
        while (isRunning) {
            // 循环切换帧
            currentFrameIndex = (currentFrameIndex + 1) % frames.length;
            try {
                Thread.sleep(frameDelays[currentFrameIndex]);
            } catch (InterruptedException e) {
                e.printStackTrace();
            }
            // 触发组件重绘
            if (getComponent() != null) {
                getComponent().repaint();
            }
        }
    }

    // 启动动画
    public void startAnimation() {
        if (animationThread == null || !animationThread.isAlive()) {
            animationThread = new Thread(this);
            animationThread.start();
        }
    }

    // 停止动画
    public void stopAnimation() {
        isRunning = false;
    }
}

使用的时候只需要替换原来的ImageIcon：

JLabel two = new JLabel();
AnimatedGIFIcon jaina = new AnimatedGIFIcon("images/jaina.gif");
two.setBounds(0, 0, 300, 300);
two.setIcon(jaina);
jaina.startAnimation(); // 别忘了启动动画！

这个方法的好处是完全掌控动画逻辑，不管GIF本身的循环设置是什么，都能强制无限循环播放。

方法二：用Swing Timer重置动画（快速临时方案） #

如果不想写自定义类，可以试试通过定时器在GIF播放完一轮后重置动画状态：

JLabel two = new JLabel();
ImageIcon jaina = new ImageIcon("images/jaina.gif");
two.setBounds(0, 0, 300, 300);
two.setIcon(jaina);

// 计算GIF一轮播放的总时长
Image gifImage = jaina.getImage();
int frameCount = ((Integer) gifImage.getProperty("frameCount", null)).intValue();
int totalPlayTime = 0;

for (int i = 0; i < frameCount; i++) {
    int delay = ((Integer) gifImage.getProperty("delay" + i, null)).intValue();
    totalPlayTime += delay > 0 ? delay : 100;
}

// 设置定时器，到点就重置动画
Timer loopTimer = new Timer(totalPlayTime, e -> {
    jaina.getImage().flush(); // 清空图像缓存
    two.setIcon(jaina); // 重新设置Icon触发重绘
});
loopTimer.setRepeats(true);
loopTimer.start();

不过这个方法有个小局限：如果GIF的帧属性读取失败（比如某些特殊格式的GIF），总时长计算就会出错，导致循环不精准。

额外检查：GIF本身的循环设置 #

别忘了先确认你的GIF文件本身是不是设置了只播放一次！有些GIF在制作时就被设为“播放1次”，这种情况下哪怕代码没问题，也只会播放一轮。你可以用GIF编辑工具（比如Photoshop、GIMP）打开看看循环设置，改成“无限循环”就行。

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