Install4j「Download file」动作HTTP错误码处理方案咨询

针对原生「Download file」动作仅处理重定向、忽略4xx/5xx错误的问题，提供以下几种可行方案：

方案1：用「Run script」动作完全替代原生下载逻辑 #

放弃原生动作，自己通过Groovy脚本实现带状态码校验的下载流程，灵活性最高。示例代码如下：

import java.net.HttpURLConnection
import java.io.InputStream
import java.io.FileOutputStream

def urlString = context.getVariable("downloadUrl") // 从变量获取下载地址
def targetPath = context.getVariable("targetFilePath") // 目标保存路径

try {
    def url = new URL(urlString)
    HttpURLConnection conn = (HttpURLConnection) url.openConnection()
    conn.setRequestMethod("GET")
    conn.connect()

    int statusCode = conn.getResponseCode()
    // 仅处理2xx成功状态码
    if (statusCode >= 200 && statusCode < 300) {
        InputStream in = conn.getInputStream()
        FileOutputStream out = new FileOutputStream(targetPath)
        
        byte[] buffer = new byte[4096]
        int bytesRead
        while ((bytesRead = in.read(buffer)) != -1) {
            out.write(buffer, 0, bytesRead)
        }
        
        out.close()
        in.close()
        context.setVariable("downloadSuccess", true)
    } else {
        // 错误状态码，弹出提示并终止流程
        context.showErrorMessage("下载失败：HTTP状态码 ${statusCode} ${conn.getResponseMessage()}")
        context.setVariable("downloadSuccess", false)
        return false // 返回false会终止安装流程
    }
} catch (Exception e) {
    context.showErrorMessage("下载出错：${e.getMessage()}")
    context.setVariable("downloadSuccess", false)
    return false
}

将这段代码放到「Run script」动作中，替换原有的「Download file」动作即可。可根据需求添加重试逻辑、进度显示（通过context.setProgress()）等扩展功能。

方案2：扩展原生「Download file」动作 #

通过自定义Java动作继承原生DownloadFileAction，重写逻辑加入状态码校验：

1. 创建Java类，继承com.install4j.runtime.actions.DownloadFileAction
2. 重写doInstall(InstallContext context)方法，在调用原生下载逻辑前先检查HTTP状态码
3. 将编译后的jar包添加到Install4j项目的「Installer->Custom code & resources」中
4. 在安装流程中使用自定义动作替代原生动作

核心重写逻辑示例：

@Override
public boolean doInstall(InstallContext context) throws IOException {
    String url = getUrl(context);
    HttpURLConnection conn = (HttpURLConnection) new URL(url).openConnection();
    conn.setRequestMethod("HEAD");
    int statusCode = conn.getResponseCode();
    
    if (statusCode >= 400) {
        context.showErrorMessage("下载失败：HTTP状态码 " + statusCode + " " + conn.getResponseMessage());
        return false;
    }
    
    // 状态码正常，执行原生下载逻辑
    return super.doInstall(context);
}

此方案保留原生动作的进度条、重定向处理等特性，仅添加错误校验逻辑。

方案3：前置状态码检查动作 #

在原生「Download file」动作前添加一个「Run script」动作，先发起HEAD请求校验状态码：

def urlString = context.getVariable("downloadUrl")
try {
    def url = new URL(urlString)
    HttpURLConnection conn = (HttpURLConnection) url.openConnection()
    conn.setRequestMethod("HEAD")
    conn.connect()
    
    int statusCode = conn.getResponseCode()
    if (statusCode >= 400) {
        context.showErrorMessage("文件不可用：HTTP状态码 ${statusCode} ${conn.getResponseMessage()}")
        return false // 终止流程，不执行后续下载动作
    }
} catch (Exception e) {
    context.showErrorMessage("无法连接到下载服务器：${e.getMessage()}")
    return false
}
return true

如果HEAD请求返回错误，直接终止流程；状态正常则继续执行原生下载动作。此方案最简单，无需修改下载逻辑，仅做前置校验。

额外建议 #

• 可将错误提示信息本地化，通过Install4j的「Language files」配置多语言提示
• 添加重试机制：在错误时弹出确认对话框，让用户选择重试或退出
• 记录错误日志：通过context.getLogger().error("下载失败", e)将错误信息写入安装日志

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