Unity创建文件夹后仍遇AssetDatabase.MoveAsset“父目录不在资源库”错误

问题描述 #

调用AssetDatabase.MoveAsset时触发"Parent directory is not in asset database"错误，即便已执行以下操作：

• 文件夹创建：使用Directory.CreateDirectory或AssetDatabase.CreateFolder
• 资源导入：调用带ImportAssetOptions.ImportRecursive参数的AssetDatabase.ImportAsset
• 资源库刷新：多处显式调用AssetDatabase.Refresh

代码示例（简化版） #

AssetData 类 #

public class AssetData
{
    public string Path { get; private set; }
    public string Name { get; private set; }
    public string SuggestedPath { get; private set; }
    public string FileExtension
    {
        get { return System.IO.Path.GetExtension(Path).ToLower(); }
    }
    public bool IsModified { get; set; } = false;

    public AssetData(string path, string name, string suggestedPath)
    {
        Path = path;
        Name = name;
        SuggestedPath = suggestedPath;
    }
}

AssetProcesser 类 #

using System;
using System.Collections.Generic;
using System.IO;
using UnityEditor;
using UnityEngine;

[ExecuteInEditMode]
public class AssetProcesser : MonoBehaviour
{
    private Queue<AssetData> m_assetsToProcess;

    public void CorrectAssets(List<AssetData> assets)
    {
        m_assetsToProcess = new Queue<AssetData>(assets);
        EditorApplication.update += ProcessAssetCorrectionQueue;
        AssetDatabase.StartAssetEditing();
    }

    private void ProcessAssetCorrectionQueue()
    {
        if (m_assetsToProcess.Count == 0)
        {
            FinishAssetCorrection();
            return;
        }

        try
        {
            foreach (AssetData asset in m_assetsToProcess)
            {
                ProcessAsset(asset);
            }
        }
        finally
        {
            AssetDatabase.StopAssetEditing();
        }
    }

    private void ProcessAsset(AssetData asset)
    {
        string guid = AssetDatabase.AssetPathToGUID(asset.Path);
        string currentPath = AssetDatabase.GUIDToAssetPath(guid);
        string newPath = asset.SuggestedPath;

        string newParentDirectory = Path.GetDirectoryName(newPath);
        CreateFolderIfNeeded(newParentDirectory);
        ImportFolderRecursive(newParentDirectory);
        AssetDatabase.Refresh(ImportAssetOptions.ImportRecursive);

        string error = AssetDatabase.MoveAsset(currentPath, newPath); // 触发错误的代码行

        if (!string.IsNullOrEmpty(error))
        {
            ToolsLogs.LogError($"Failed to rename asset {asset.Path}: {error}");
        }

        AssetDatabase.ImportAsset(newPath, ImportAssetOptions.ImportRecursive);
    }

    private static void CreateFolderIfNeeded(string folderPath)
    {
        if (!folderPath.StartsWith("Assets/"))
        {
            ToolsLogs.LogError("Invalid path. Path must be within the Assets folder.");
            return;
        }

        string[] folders = folderPath.Substring("Assets/".Length).Split('/');
        string currentPath = "Assets";

        if (!AssetDatabase.IsValidFolder(folderPath))
        {
            try
            {
                for (int i = 0; i < folders.Length; i++)
                {
                    string folderName = folders[i];
                    currentPath = Path.Combine(currentPath, folderName);

                    if (AssetDatabase.IsValidFolder(currentPath))
                    {
                        continue;
                    }

                    string createdFolderGuid = AssetDatabase.CreateFolder(Path.GetDirectoryName(currentPath), Path.GetFileName(currentPath));

                    if (!string.IsNullOrEmpty(createdFolderGuid))
                    {
                        AssetDatabase.ImportAsset(currentPath, ImportAssetOptions.ImportRecursive);
                        Debug.Log($"Created folder: {createdFolderGuid}");
                    }
                }
            }
            catch (Exception ex)
            {
                Debug.LogError($"Error creating directory: {ex.Message}");
            }
        }
    }

    private static void ImportFolderRecursive(string folderPath)
    {
        AssetDatabase.ImportAsset(folderPath, ImportAssetOptions.ImportRecursive | ImportAssetOptions.ForceSynchronousImport);
    }

    private void FinishAssetCorrection()
    {
        EditorUtility.ClearProgressBar();
        EditorApplication.update -= ProcessAssetCorrectionQueue;
        AssetDatabase.Refresh();
    }
}

环境 #

• Unity版本：2021.3.15f1
• 操作系统：macOS

已尝试方案 #

• 日志调试：确认文件夹在文件系统中存在，但未被资源库识别
• 强制延迟：增加延迟并尝试协程
• 文件夹创建替代方案：更换不同的文件夹创建逻辑

核心问题 #

1. 资源库无法立即识别新创建目录的常见原因有哪些？
2. 有没有更有效的方法强制文件系统与资源库同步？
3. 资产处理脚本的其他部分是否可能干扰文件夹识别？

补充说明 #

• 若常规方案无效，可排查meta文件问题
• 脚本仅在Unity编辑器运行，不属于运行时/构建逻辑，提供代码为实际代码库简化版本

解决方案与见解 #

1. 资源库无法识别新目录的常见原因 #

• 路径格式问题：macOS下混用/和\分隔符，或路径未严格以Assets/开头，导致Unity无法正确解析
• 操作时序冲突：CreateFolder后立即执行导入/刷新，Unity内部元数据生成未完成，资源库未同步
• Meta文件异常：新文件夹未生成对应.meta文件，或.meta文件权限受限（macOS权限限制导致Unity无法写入）
• 批量操作锁阻塞：AssetDatabase.StartAssetEditing()的范围不当，导致文件夹创建的元数据被延迟处理

2. 强制文件系统与资源库同步的有效方法 #

• 同步刷新+元数据写入：调用AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport)后，执行AssetDatabase.SaveAssets()确保元数据写入磁盘，再通过EditorApplication.delayCall等待一帧后执行移动操作
• 有效性重试验证：移动前循环检查AssetDatabase.IsValidFolder(newParentDirectory)，最多重试3次，避免死循环
• 主线程执行：所有AssetDatabase操作必须在主线程执行，Unity编辑器API不支持异步调用

3. 脚本中可能干扰文件夹识别的问题点 #

• 批量编辑锁时序错位：CorrectAssets中启动StartAssetEditing()，但实际操作在EditorApplication.update回调中执行，导致锁范围与操作时序不匹配，元数据被缓存
• 队列处理逻辑问题：一次性遍历所有队列元素，StopAssetEditing()直接结束批量操作，导致单个资产的刷新被阻塞
• 路径拼接错误：CreateFolderIfNeeded中使用Path.Combine，macOS下可能生成带\的路径，Unity无法识别为有效资源路径

针对性代码修改建议 #

1. 统一路径分隔符，替换Path.Combine：

currentPath = $"{currentPath}/{folderName}";

2. 调整批量编辑锁范围，每帧处理单个资产：

private void ProcessAssetCorrectionQueue()
{
    if (m_assetsToProcess.Count == 0)
    {
        FinishAssetCorrection();
        return;
    }

    var asset = m_assetsToProcess.Dequeue();
    try
    {
        AssetDatabase.StartAssetEditing();
        ProcessAsset(asset);
    }
    finally
    {
        AssetDatabase.StopAssetEditing();
        AssetDatabase.SaveAssets();
        AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport);
    }
}

3. 移动前增加文件夹有效性验证：

int retryCount = 0;
while (!AssetDatabase.IsValidFolder(newParentDirectory) && retryCount < 3)
{
    AssetDatabase.Refresh(ImportAssetOptions.ForceSynchronousImport);
    AssetDatabase.SaveAssets();
    retryCount++;
    EditorApplication.delayCall += () => {};
}

if (!AssetDatabase.IsValidFolder(newParentDirectory))
{
    ToolsLogs.LogError($"Parent directory {newParentDirectory} is still invalid after retries");
    return;
}

string error = AssetDatabase.MoveAsset(currentPath, newPath);

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