Mac下jpackage打包的Java .App无法写入文件系统问题求助

为什么 .app 和 jlink 镜像的路径表现不同？ #

1. 运行时工作目录差异 #

• IDE或jlink镜像运行时，Java进程的工作目录默认是项目根目录/用户当前目录，相对路径会基于这个可写入的目录解析，因此不会触发权限错误。
• .app作为Mac原生应用，默认运行时的工作目录是系统根目录 /，这个目录是只读的，若代码中使用相对路径写入文件（如new File("data.txt")），会直接尝试写入根目录，触发Read-only file system错误。

2. 应用包内部路径只读 #

你通过getClass().getProtectionDomain().getCodeSource().getLocation()获取的路径是.app包内部的资源目录（例如/Applications/hello.app/Contents/Resources/app/），Mac系统会锁定应用包使其只读，防止篡改，因此无法向该路径写入文件。

解决方法 #

1. 强制使用用户可写入的绝对路径 #

确保所有写入操作都基于用户主目录（user.home）拼接绝对路径，避免使用相对路径。示例代码：

// 规范的路径拼接方式，避免分隔符错误
import java.nio.file.Files;
import java.nio.file.Paths;
import java.nio.charset.StandardCharsets;

String userHome = System.getProperty("user.home");
Path outputPath = Paths.get(userHome, "Documents", "app_output.txt");
// 写入文件
Files.write(outputPath, "测试内容".getBytes(StandardCharsets.UTF_8));

注意：不要手动拼接字符串路径（如userHome + "/Documents/file.txt"），不同系统的路径分隔符不同，用Paths类更可靠。

2. 处理沙盒权限（针对Mac App Store分发） #

如果你的.app要提交Mac App Store，jpackage会自动启用沙盒机制，此时需要在entitlements.plist中申请文件读写权限：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.security.files.user-selected.read-write</key>
    <true/>
    <key>com.apple.security.files.documents.read-write</key>
    <true/>
</dict>
</plist>

打包时通过--mac-entitlements参数指定该文件：

jpackage --type app-image --input ./build --main-jar HelloApp.jar --main-class com.example.HelloMain --mac-entitlements ./entitlements.plist

3. 验证当前工作目录 #

可以在代码中打印当前工作目录，确认问题根源：

System.out.println("当前工作目录: " + System.getProperty("user.dir"));

若输出为/，则说明是工作目录导致的写入根目录问题，必须改用绝对路径。

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