如何从带额外参数的Web URL中提取文件名与扩展名

我太懂你踩的这个坑了——用new File(new URI(url).getPath()).getName()这种传统方法，遇到文件名藏在查询参数里，或者URL末尾带一堆额外参数的情况，直接就失效了。比如你举的两个例子：第一个的真实文件名在wallfilename参数里，第二个的文件名后面跟着缓存key参数，原来的逻辑根本抓不到正确结果。

下面给你一套健壮的解决方案，覆盖常见的异常场景：

核心思路 #

我们需要分两种情况针对性处理：

1. 文件名在URL路径的末尾（但可能跟着查询参数）；
2. 文件名直接存储在查询参数中（比如你的第一个跳转类URL）。

用Java的URL类来解析URL结构，比直接操作字符串或者URI更可靠，它能帮我们自动分离路径、查询参数等核心部分。

完整代码实现 #

import java.net.MalformedURLException;
import java.net.URL;
import java.net.URLDecoder;
import java.nio.charset.StandardCharsets;

public class UrlFileNameExtractor {
    public static String extractFileName(String urlString) throws MalformedURLException {
        URL url = new URL(urlString);
        String fileName = "";

        // 第一步：从URL路径中提取文件名（自动排除查询参数）
        String path = url.getPath();
        if (!path.isEmpty()) {
            int lastSlashIndex = path.lastIndexOf('/');
            fileName = path.substring(lastSlashIndex + 1);
        }

        // 第二步：如果路径中是跳转页面（比如aspx/php），去查询参数找真实文件名
        if (fileName.isEmpty() || fileName.matches(".*\\.(aspx|php|jsp)$")) {
            String query = url.getQuery();
            if (query != null) {
                String[] params = query.split("&");
                // 遍历查询参数，匹配常见的文件名参数key
                for (String param : params) {
                    String[] keyValue = param.split("=");
                    if (keyValue.length == 2) {
                        String key = keyValue[0];
                        String value = keyValue[1];
                        // 可根据业务扩展更多参数key，比如filename、file、image等
                        if ("wallfilename".equalsIgnoreCase(key) || "filename".equalsIgnoreCase(key)) {
                            fileName = value;
                            break;
                        }
                    }
                }
            }
        }

        // 第三步：处理URL编码的文件名（比如空格变成%20、特殊字符转码）
        if (!fileName.isEmpty()) {
            fileName = URLDecoder.decode(fileName, StandardCharsets.UTF_8.name());
        }

        // 边界处理：如果还是没拿到文件名，可根据需求返回默认值或抛出异常
        if (fileName.isEmpty()) {
            throw new IllegalArgumentException("无法从URL中提取有效文件名：" + urlString);
        }

        return fileName;
    }

    // 测试示例
    public static void main(String[] args) throws MalformedURLException {
        String url1 = "https://wallpaperclicker.com/wallpaper/Download.aspx?wallfilename=samplehd-pics-87908344.jpg";
        String url2 = "https://spxt-sjc2-1.cdnagram.com/t51.2885-15/s980x480/e35/20969138_31213_564630462529635_5170096177993632_n.jpg?ig_cache_key=M0003NTyMTc3MjY5MDE4Nw%3D%3D.2";
        
        System.out.println(extractFileName(url1)); // 输出：samplehd-pics-87908344.jpg
        System.out.println(extractFileName(url2)); // 输出：20969138_31213_564630462529635_5170096177993632_n.jpg
    }
}

关键细节说明 #

• 用URL类解析结构：url.getPath()会自动剥离查询参数，直接拿到纯路径部分；url.getQuery()能获取所有查询参数，方便我们提取藏在参数里的真实文件名。
• 适配跳转类URL：如果路径里的文件名是.aspx、.php这类跳转页面，自动去查询参数里找目标文件名，你可以根据业务场景扩展更多这类后缀。
• URL解码处理：针对文件名被URL编码的情况（比如空格转成%20），确保拿到原始的真实文件名。
• 可扩展性：你可以在查询参数遍历部分，添加更多业务中常见的文件名参数key，比如file、imageName等。

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