问题解决记录：Mac系统上传目录时的垃圾文件清理

问题背景在上传图片系统中当用户使用苹果本Mac压缩并上传目录时系统出现异常。经过排查发现Mac 系统在压缩时会自动生成大量隐藏文件和元数据目录这些垃圾文件在解压后会干扰系统的正常业务逻辑。Mac 系统自动生成的垃圾文件包括.DS_Store- 存储文件夹显示设置图标位置、背景等__MACOSX- 包含资源分叉数据resource fork的元数据目录._开头的文件- 每个文件的元数据副本如 ._photo.jpg其他以 . 开头的隐藏文件这些文件在 Mac 环境下是正常的但在上传到图片系统后会导致系统将这些垃圾文件也当作商品图片处理文件数量统计错误业务逻辑混乱如主图设置错误解压操作因编码问题失败问题定位过程通过Claude Code AI 助手的协助按照以下步骤定位和解决问题描述问题向 AI 详细说明问题现象 - Mac 用户压缩上传目录后系统出错而 Windows 用户正常AI 分析根因AI 指出 Mac 系统的 ZIP 压缩会自动包含隐藏文件以 . 开头__MACOSX元数据目录编码格式差异Mac 默认 UTF-8Windows 默认 GBK制定解决方案AI 建议采用双重策略清理策略解压后自动删除 Mac 垃圾文件兼容策略改进 ZIP 解压的编码处理支持 Mac 格式解决方案实施1. 新增 Mac 垃圾文件清理工具类位置src/main/java/net/shopin/pz/util/DeleteForder.java核心方法deleteMacHiddenFiles(File directory)123456789101112131415161718192021222324252627282930313233343536/*** 删除Mac系统压缩时产生的隐藏文件和目录* param directory 需要清理的目录*/publicstaticvoiddeleteMacHiddenFiles(File directory) {// 1. 参数校验if(directory null|| !directory.exists() || !directory.isDirectory()) {return;}// 2. 递归遍历目录for(File file : directory.listFiles()) {String fileName file.getName();// 3. 删除以 . 开头的隐藏文件.DS_Store、._*等if(fileName.startsWith(.)) {if(file.isDirectory()) {recurDelete(file);// 递归删除目录}else{file.delete();// 直接删除文件}continue;}// 4. 删除 __MACOSX 元数据目录双重保险if(__MACOSX.equalsIgnoreCase(fileName)) {recurDelete(file);continue;}// 5. 递归处理子目录if(file.isDirectory()) {deleteMacHiddenFiles(file);}}}清理逻辑删除所有以.开头的隐藏文件和目录覆盖.DS_Store、._*等专门删除__MACOSX目录双重保险递归处理所有子目录确保深层垃圾文件也被清理添加详细日志记录便于问题追踪2. 在文件上传流程中集成清理逻辑位置/controller/FileUploadController.java12345678910111213141516//解压zip文件结束logger.info(解压文件 file.getOriginalFilename() 结束);// ✅ 新增清理Mac系统压缩产生的隐藏文件try{logger.info(跟踪信息 uuid --清理Mac隐藏文件-:[ shopName - planCreatedTime - photoTitle ] username );DeleteForder.deleteMacHiddenFiles(picDir);// 调用清理方法logger.info(清理Mac隐藏文件完成);}catch(Exception e) {logger.error(清理Mac隐藏文件时出现异常 e);e.printStackTrace();}//目录遍历//... 后续业务逻辑3. 改进 ZIP 解压的编码兼容性位置/util/ZipLinuxUtil.java问题分析Windows 系统压缩默认使用 GBK 或 GB18030 编码Mac 系统压缩默认使用 UTF-8 编码原代码只支持 Windows 格式导致 Mac 压缩文件解压失败解决方案双重编码尝试机制12345678910111213141516171819/*** 解压ZIP文件自动检测编码兼容Mac和Windows*/publicstaticvoidunzip(String sourceZip, String destDir)throwsException {try{// 第一次尝试自动检测编码解压unzipWithDetectedEncoding(sourceZip, destDir);}catch(Exception e) {// 如果失败尝试用UTF-8编码重试兼容Mac系统压缩的文件logger.warn(第一次解压失败尝试使用UTF-8编码重试 e.getMessage());try{unzipWithEncoding(sourceZip, destDir,UTF-8);logger.info(使用UTF-8编码重试成功);}catch(Exception ex) {logger.error(使用UTF-8编码重试也失败 ex.getMessage());throwe;// 抛出原始异常}}}4. 增强 null 值处理和错误日志在提交中进一步完善File.listFiles()返回null时的安全处理所有delete()操作都检查返回值失败时记录警告日志编码检测为null时使用默认编码GBK12345678910// 示例安全删除操作File[] files f.listFiles();if(files null) {// listFiles()返回null可能是权限问题或IO错误booleandeleted f.delete();if(!deleted) {logger.warn(无法删除文件或目录可能无权限或目录非空 f.getPath());}return;}修复前后对比对比项修复前修复后Mac 垃圾文件❌ 被当作正常图片处理导致业务错误✅ 自动清理不影响业务逻辑ZIP 解压编码❌ Mac 压缩文件解压失败✅ 兼容 MacUTF-8和 WindowsGBKnull 值处理❌ 可能导致空指针异常✅ 全面的 null 检查和降级处理错误日志❌ 删除失败无提示✅ 详细的警告和错误日志测试验证修复后在 Mac 系统上进行完整测试✅ Mac 系统压缩的 ZIP 文件可以正常解压✅__MACOSX目录被自动删除✅.DS_Store等隐藏文件被自动删除✅._*元数据文件被自动删除✅ 只有真正的商品图片被系统识别和处理✅ Windows 系统压缩的文件仍然正常工作向下兼容技术总结1. Mac 系统的 ZIP 压缩特性Mac 的 Archive Utility 或 Finder 压缩功能会自动包含元数据这些元数据在 Windows/Linux 系统中是冗余的垃圾文件跨平台文件传输需要特别处理2. ZIP 文件编码差异WindowsGBK/GB18030中文系统默认Mac/LinuxUTF-8解决方案自动检测 双重尝试机制3. Java 文件操作的注意事项File.listFiles()可能返回null权限问题、不是目录、IO错误File.delete()要检查返回值判断是否真正删除成功递归删除要考虑深层目录和权限问题4. AI 辅助调试的优势快速识别跨平台兼容性问题提供多种解决方案供选择自动生成健壮的防御性代码解释技术背景和最佳实践相关代码提交Commit 83ccaa8- fix: DEV-2548 尝试解决图片系统在苹果本上传目录报错的问题新增deleteMacHiddenFiles方法在 FileUploadController 中集成清理逻辑改进 ZIP 解压的编码兼容性Commit 7278bad- fix: DEV-2548 尝试解决拍照系统苹果本上传目录报错的问题 - 解决 null问题增强 null 值处理添加删除失败的警告日志完善编码检测的降级处理后续优化建议考虑在文件上传时就检测操作系统类型针对性处理对于大文件考虑异步清理以提高响应速度添加清理统计信息清理了多少个垃圾文件