Mac环境使用Java版Selenium实现无input标签文件上传问题咨询

现有方案失效的核心原因 #

• 权限缺失：MacOS 10.14及以上版本对系统级键盘控制有严格权限限制，运行Java程序的进程（IDE/终端）没开辅助功能、System Events自动化权限的话，所有模拟键盘操作都会静默失效
• 调用方式错误：直接通过Runtime.exec()执行AppleScript文件路径不会自动加载脚本运行环境，相当于直接把脚本文件当二进制程序跑，根本不会执行脚本逻辑
• 焦点问题：点击上传按钮后没有等系统文件选择窗口前置就发送快捷键，指令会发到当前焦点的浏览器窗口，不会触发文件选择框的路径跳转
• 兼容性问题：Java AWT Robot类在Mac平台对原生系统窗口的焦点识别兼容性极差，多屏、多桌面场景下按键发送目标大概率错乱

前置权限配置（必做，否则所有方案都不生效） #

1. 打开系统设置→隐私与安全性→辅助功能，将你运行Java程序的进程（IDEA/Eclipse/终端等）添加到列表并勾选授权
2. 同页面进入自动化选项，找到对应运行进程，勾选其下的「System Events」权限
3. 授权完成后重启对应的IDE/终端，确保权限缓存生效

可直接落地的实现代码 #

不用维护独立AppleScript文件，直接通过osascript -e执行内联脚本即可，天然支持传入Java侧定义的文件路径参数：

import java.io.BufferedReader;
import java.io.InputStreamReader;

public class MacFileUploadUtil {
    public static void uploadFileByAppleScript(String absoluteFilePath) throws Exception {
        // 注意：必须传入文件的绝对路径，不支持~开头的用户目录缩写、相对路径
        // 对路径中的特殊字符做转义，避免AppleScript语法错误
        String escapePath = absoluteFilePath.replace("\\", "\\\\").replace("\"", "\\\"");
        
        String script = String.join("\n",
                "tell application \"System Events\"",
                "delay 0.5",
                // 强制将文件选择窗口（归属Finder进程）置为前台，避免焦点错位
                "set frontmost of process \"Finder\" to true",
                "delay 0.3",
                // 触发Cmd+Shift+G打开路径跳转弹窗
                "keystroke \"G\" using {command down, shift down}",
                "delay 0.5",
                // 输入目标文件路径
                "keystroke \"" + escapePath + "\"",
                "delay 0.3",
                // 回车确认路径跳转，选中目标文件
                "keystroke return",
                "delay 0.3",
                // 回车确认上传，关闭文件选择窗口
                "keystroke return",
                "end tell"
        );

        String[] cmd = {"osascript", "-e", script};
        Process process = Runtime.getRuntime().exec(cmd);
        // 等待脚本执行完成，检查执行结果
        int exitCode = process.waitFor();
        if (exitCode != 0) {
            BufferedReader errReader = new BufferedReader(new InputStreamReader(process.getErrorStream()));
            StringBuilder errMsg = new StringBuilder();
            String line;
            while ((line = errReader.readLine()) != null) {
                errMsg.append(line);
            }
            throw new RuntimeException("文件上传脚本执行失败: " + errMsg);
        }
    }

    // 调用示例
    public static void main(String[] args) throws Exception {
        // 假设driver已经初始化完成，先点击页面上的上传按钮
        // driver.findElement(By.xpath("你的上传按钮定位表达式")).click();
        // 等待文件选择窗口弹出
        Thread.sleep(500);
        // 传入要上传的文件绝对路径执行上传
        uploadFileByAppleScript("/Users/yourname/Documents/test-upload.pdf");
    }
}

独立AppleScript文件的参数传递方法 #

如果脚本逻辑复杂需要抽成独立.scpt文件，可以通过命令行位置参数传值：

1. 编写AppleScript脚本文件（比如命名为upload.scpt），通过argv接收传入的路径参数：

on run argv
    -- 取第一个命令行参数作为上传文件路径
    set uploadPath to item 1 of argv
    tell application "System Events"
        delay 0.5
        set frontmost of process "Finder" to true
        delay 0.3
        keystroke "G" using {command down, shift down}
        delay 0.5
        keystroke uploadPath
        delay 0.3
        keystroke return
        delay 0.3
        keystroke return
    end tell
end run

2. Java侧调用时把文件路径拼在命令参数后面即可：

String scriptPath = "/Users/yourname/script/upload.scpt";
String uploadFilePath = "/Users/yourname/test.pdf";
// 命令格式：osascript 脚本路径 参数1 参数2...
String[] cmd = {"osascript", scriptPath, uploadFilePath};
Runtime.getRuntime().exec(cmd).waitFor();

常见问题排查 #

• 如果按键无响应，优先检查权限配置，其次把脚本里的delay数值调大，性能差的机器窗口加载慢，快捷键发送过早会失效
• 如果提示找不到文件，检查路径是不是全绝对路径，不要用~/Desktop/xxx.jpg这类缩写，必须写完整的/Users/xxx/Desktop/xxx.jpg
• 如果路径包含空格、中文不用额外处理，AppleScript的keystroke可以正常识别，只要提前转义双引号、反斜杠即可
• 不要用Java Robot类实现Mac端的原生窗口操作，焦点错位概率极高，稳定性远低于AppleScript方案

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