babalae/better-genshin-impact · error · FileNotFoundException

未找到首领路线文件:{route}

Error message

未找到首领路线文件:{route}

What it means

Validate 遍历 GetRequiredRouteFiles(BossName),对每个路线文件用 BuildPathingAssetPath 拼接绝对路径后 File.Exists 检查,缺失即抛 FileNotFoundException(含文件名与路径作为参数)。路线文件是程序内置资产,缺失属安装损坏或 Boss 支持不完整。

Source

Thrown at BetterGenshinImpact/GameTask/AutoBoss/AutoBossTask.cs:1027

        {
            throw new Exception("只有指定讨伐次数模式才能开启须臾树脂或脆弱树脂补充");
        }

        if (string.IsNullOrWhiteSpace(_taskParam.CombatStrategyPath))
        {
            _taskParam.SetCombatStrategyPath(_taskParam.StrategyName);
        }

        if (!File.Exists(_taskParam.CombatStrategyPath) && !Directory.Exists(_taskParam.CombatStrategyPath))
        {
            throw new Exception("当前选择的自动战斗策略文件不存在");
        }

        foreach (var route in GetRequiredRouteFiles(_taskParam.BossName))
        {
            if (!File.Exists(BuildPathingAssetPath(route)))
            {
                throw new FileNotFoundException($"未找到首领路线文件:{route}", BuildPathingAssetPath(route));
            }
        }
    }

    /// <summary>
    /// 获取指定 Boss 启动任务前必须存在的路线文件名。
    /// </summary>
    /// <param name="bossName">Boss 名称。</param>
    /// <returns>需要校验的路线文件名序列。</returns>
    private static IEnumerable<string> GetRequiredRouteFiles(string bossName)
    {
        if (AutoBossData.IsNoPathingSupportBoss(bossName))
        {
            yield return $"{bossName}强制传送.json";
            yield return $"{bossName}键鼠前往.json";
            yield break;
        }

View on GitHub (pinned to a7cb36712d)

Solutions

  1. 重新安装/修复程序以补全 AutoBoss Pathing 资产。
  2. 检查 PathingAssetFolder(Global.Absolute('GameTask\\AutoBoss\\Assets\\Pathing'))下是否存在报错文件名。
  3. 若为自定义 Boss,确认对应路线文件已放入资产目录且命名匹配。
Defensive patterns

Strategy: validation

Validate before calling

foreach (var route in GetRequiredRouteFiles(_taskParam.BossName))
{
    var p = BuildPathingAssetPath(route);
    if (!File.Exists(p)) { /* 启动前提示资产缺失,建议重装 */ }
}

Prevention

When it happens

Trigger: GameTask/AutoBoss/Assets/Pathing 下对应 Boss 的 'XXX前往.json' 或 'XXX强制传送.json' 缺失;程序资产未随版本正确部署;BossName 与文件名命名规则不一致。

Common situations: 打包/安装遗漏资产;用户手动删除资产目录;Boss 支持名单与资产文件不同步(名单含但文件未提供)。

Related errors


AI-assisted analysis of babalae/better-genshin-impact@a7cb36712d (2026-08-13). Data as JSON: /api/errors/cce98dd108228549. Report an issue: GitHub.