babalae/better-genshin-impact · error · Exception

暂不支持首领:{_taskParam.BossName}

Error message

暂不支持首领:{_taskParam.BossName}

What it means

Validate 用 AutoBossData.IsSupportedBoss(BossName) 校验所选 Boss 是否在支持列表内,不支持即抛 Exception。这通常因 BossName 拼写、大小写或版本差异导致与支持名单不匹配。

Source

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

        };
        return taskParam;
    }

    /// <summary>
    /// 校验自动首领讨伐启动所需的 Boss、战斗策略、讨伐次数、补充树脂开关、重试次数和路线文件。
    /// </summary>
    /// <exception cref="Exception">配置缺失、Boss 不支持、策略不存在或重试次数非法时抛出。</exception>
    /// <exception cref="FileNotFoundException">必需路线文件不存在时抛出。</exception>
    private void Validate()
    {
        if (string.IsNullOrWhiteSpace(_taskParam.BossName))
        {
            throw new Exception("请选择需要讨伐的首领");
        }

        if (!AutoBossData.IsSupportedBoss(_taskParam.BossName))
        {
            throw new Exception($"暂不支持首领:{_taskParam.BossName}");
        }

        if (_taskParam.ReviveRetryCount < 0)
        {
            throw new Exception("角色死亡后重试次数不能小于 0");
        }

        if (_taskParam.SpecifyRunCount && _taskParam.RunCount < 1)
        {
            throw new Exception("指定讨伐次数必须大于 0");
        }

        if (!_taskParam.SpecifyRunCount && (_taskParam.UseTransientResin || _taskParam.UseFragileResin))
        {
            throw new Exception("只有指定讨伐次数模式才能开启须臾树脂或脆弱树脂补充");
        }

        if (string.IsNullOrWhiteSpace(_taskParam.CombatStrategyPath))

View on GitHub (pinned to a7cb36712d)

Solutions

  1. 从 AutoBossData 支持列表中选择 Boss 而非手填。
  2. 检查 BossName 与 AutoBossData 中名单的精确字符(含全角字符、空格)。
  3. 更新程序版本以获取新增 Boss 支持。
  4. 在 UI 用下拉框限定可选 Boss。
Defensive patterns

Strategy: validation

Validate before calling

if (!AutoBossData.IsSupportedBoss(_taskParam.BossName))
{
    // UI 用支持下拉框限定可选 Boss
}

Prevention

When it happens

Trigger: BossName 来自手填/旧配置,与 AutoBossData 支持名单字符串不一致;游戏新增 Boss 但程序尚未更新支持名单;名称含全角/半角差异或多余空白。

Common situations: 用户手动编辑配置文件填错 Boss 名;跨版本配置不兼容;本地化名称差异。

Related errors


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