APFS Sparse Bundle & Reboot

[yuanweize]

If your Mac is not shut down gracefully (e.g., power loss, forced reboot), the APFS sparse bundle used for Game Libraries might report data verification issues. This can cause the volume to become read-only or refuse to write data.

Workaround:

Open Disk Utility.
Select the mounted volume (e.g., SteamLibrary).
Click First Aid and let it run.
Once verified, it will work normally again.
Note: Standard SMB, Rclone, and SFTP mounts are not affected by this issue.

Welcome to PR for fix this issue, I suggest ejecting the APFS after mounting it, then remounting it and running First Aid. The logic and commands for mounting APFS in the script need to be optimized.

APFS is mounted as SteamLib

[yuanweize]

Running First Aid on “SMB_APFS” (disk5s1)

Checking file system and repairing if necessary and if possible.
Volume was successfully unmounted.
Performing fsck_apfs -y -x /dev/rdisk5s1
Checking the container superblock.
Checking the checkpoint with transaction ID 2948.
Checking the space manager.
Checking the space manager free queue trees.
Checking the object map.
Checking volume /dev/rdisk5s1.
Checking the APFS volume superblock.
The volume SMB_APFS was formatted by storagekitd (2632.40.17) and last modified by apfs_kext (2632.40.17).
Checking the object map.
Checking the snapshot metadata tree.
Checking the snapshot metadata.
Checking the fsroot tree.
Checking the extent ref tree.
Verifying volume object map space.
Verifying allocated space.
The volume /dev/rdisk5s1 with UUID 265ED1AE-292A-4442-9A44-DEE6E7D98A94 appears to be OK.
File system check exit code is 0.
Restoring the original state found as mounted.

Operation successful.