[Tracking] Terracotta MacOS 相关问题

[burningtnt]

本 Discussion 用于跟踪陶瓦联机在 MacOS 上的相关问题，请求社区帮助寻找修复方式

问题列表：

• osascript 在 installer 成功执行后不能正常退出
• MacOS 15 上创建端口转发时有概率获得报错：端口被占用
• MacOS 14 上安装陶瓦时报错：0:207: execution error: shell-init: error retrieving current directory: getcwd: cannot access parent directories: Operation not permitted (1)

[WhatDamon]

HMCL/HMCL/src/main/java/org/jackhuang/hmcl/terracotta/provider/MacOSProvider.java

Lines 64 to 78 in f1c8791

	installerTask.thenComposeAsync(() -> {
	ManagedProcess process = new ManagedProcess(new ProcessBuilder(
	"osascript",
	"-e",
	String.format(
	"do shell script \"installer -pkg %s -target /Applications\" with prompt \"%s\" with administrator privileges",
	installer.getPath(),
	i18n("terracotta.sudo_installing")
	)
	));
	process.pumpInputStream(SystemUtils::onLogLine);
	process.pumpErrorStream(SystemUtils::onLogLine);
	return Task.fromCompletableFuture(process.getProcess().onExit());
	}),

看起来这里使用过 installer 实现安装的，但是target不应该是/Applications，这里请求的应该是宗卷，故应该是用/，但是installer似乎会自动使用/来替换这里面target，可以解决第一个问题，也有可能一次性两者都解决了

具体改为："do shell script \"installer -pkg %s -target /\" with prompt \"%s\" with administrator privileges"

[burningtnt]

感谢，该修复确实有效。

[burningtnt]

在 MacOS [待调查影响范围] 上 osascript 可能不能正常在安装完成后自动退出

[WhatDamon]

估计是报错导致的问题，请尝试先解决一下，下面我提供了另外一种理论可行的方案，可以尝试一下

[WhatDamon]

在我这里修改了-target问题后依旧无法安装成功，经过测试，我推荐先把pkg安装文件复制到/tmp目录，这样可以避免AppleScript玄学的路径问题，提高成功安装的可能性

另外经过测试，在安装失败后导出日志会变得异常缓慢，这个在其他平台也可以测试一下
还有最好能够在安装过程中显示安装日志，这样可以减轻追踪难度（至少不用在日志文件中大海捞针），并且加入几个基本的规则判断，防止提供的报错信息模棱两可

[WhatDamon]

2025-10-06T22-00-53.log

...
591 [22:01:04] [@.util.platform.SystemUtils.onLogLine/INFO] 0:224: execution error: shell-init: error retrieving current directory: getcwd: cannot access parent directories: Operation not permitted (1)
...
601 [22:01:05] [@.util.platform.SystemUtils.onLogLine/INFO] [UI]: Failed to start daemon: Process 'launchctl' failed: ExitStatus(unix_wait_status(1280))
...

macOS的权限问题的确有点玄学，我自己之前给其他软件做macOS适配的时候这种问题也折腾了我好久

[WhatDamon]

可以考虑使用的目录还有

• ~/Library/Application Support/hmcl
• ~/Library/Caches/hmcl

这些目录都可以进行测试，理论上同样可以解决权限问题

note: ~请替换为用户主目录，使用绝对路径来避免潜在问题

[burningtnt]

是否有办法判断某文件会被重定向到其他文件夹？我注意到 MacOS 对目录重定向的处理（在 /tmp 上测试）是完全透明的，似乎不能判定一个文件是否被重定向。

[WhatDamon]

是否有办法判断某文件会被重定向到其他文件夹？我注意到 MacOS 对目录重定向的处理（在 /tmp 上测试）是完全透明的，似乎不能判定一个文件是否被重定向。

在我这里它被重定向到了`/private/tmp`目录，命令见上图

[burningtnt]

现在，HMCL 安装陶瓦时会先将安装包复制到 ~/Library/Application Support/hmcl//terracotta--macos-.pkg 以尽量解决权限问题。

[burningtnt]

terracotta-log-2025-10-16T15-08-12.zip

MacOS 15 上创建端口转发时有概率获得报错：端口被占用。原因不明。

[burningtnt]

已确定是 MacOS 关闭套接字的操作疑似有“延迟”，已在 Terracotta 中添加端口转发创建的重试逻辑来缓解该问题。

[burningtnt]

0:207: execution error: shell-init: error retrieving current directory: getcwd: cannot access parent directories: Operation not permitted (1)

MacOS 14 上有用户报告了上述错误。

[WhatDamon]

问题分析为权限问题，在macOS下，哪怕拥有root权限也会被大量系统保护机制限制
可能需要考虑一下让Terracotta在不容易受到权限限制的地方进行安装，如果按照目前的方式，是否能够成功安装与用户存放HMCL的位置密切相关

目前猜测osascript无法退出（不过这个我这里无法复现）与此问题均为macOS权限限制导致的

[WhatDamon]

目前还有一个可以考虑的被选备选方案，使用sudo（只要用户在wheel组，成功的概率相比Apple Script更高一点），双方案是否值得被考虑？

[SPB8866]

[SPB8866]

ok

[SPB8866]

nothing happened it stayed the same

[SPB8866]

after reinstall

[WhatDamon]

若依旧存在问题，请尝试使用Pearcleaner等工具对陶瓦进行彻底的删除，然后重新尝试HMCL自动安装，若依旧不行，使用上述工具执行卸载后请手动下载适用于你的设备的pkg安装包进行手动安装
注意，如果在卸载工具中找不到陶瓦（Terracotta），大概率代表着陶瓦没有成功安装，若是这种情况，请额外说明！

[SPB8866]

找到 删了 但还是一样

[SPB8866]

[burningtnt]

1. 请直接在上面那一【楼】回复；
2. 导出的日志应当为一个 .zip 文件。请上传整个压缩包，不要只上传其中的一个文件。