babalae/better-genshin-impact · error · InvalidOperationException

marker_doc/list_page_bin_md5 返回错误: {result.Message ?? "未知错误"

Error message

marker_doc/list_page_bin_md5 返回错误: {result.Message ?? "未知错误"}

What it means

Error "marker_doc/list_page_bin_md5 返回错误: {result.Message ?? "未知错误"}" thrown in babalae/better-genshin-impact.

Source

Thrown at BetterGenshinImpact/Service/Tavern/KongyingTavernApiService.cs:304

    private async Task<List<ListPageBinMd5Item>> GetMarkerDocPageMd5ListAsync(CancellationToken ct)
    {
        await EnsureAccessTokenAsync(ct);
        var uri = BuildUri(MarkerDocListPageBinMd5Path);
        using var request = CreateRequest(HttpMethod.Get, uri);
        using var resp = await _httpClient.SendAsync(request, ct);
        resp.EnsureSuccessStatusCode();
        var json = await resp.Content.ReadAsStringAsync(ct);

        var result = JsonConvert.DeserializeObject<KongyingTavernResponse<List<ListPageBinMd5Item>>>(json);
        if (result is null)
        {
            throw new InvalidOperationException("marker_doc/list_page_bin_md5 返回内容无法反序列化");
        }

        if (result.Error)
        {
            throw new InvalidOperationException($"marker_doc/list_page_bin_md5 返回错误: {result.Message ?? "未知错误"}");
        }

        return result.Data ?? [];
    }

    private async Task<byte[]> GetMarkerDocPageBinAsync(string md5, CancellationToken ct)
    {
        await EnsureAccessTokenAsync(ct);
        var uri = BuildUriWithId(MarkerDocListPageBinPathPrefix, md5);
        using var request = CreateRequest(HttpMethod.Get, uri);
        using var resp = await _httpClient.SendAsync(request, ct);
        resp.EnsureSuccessStatusCode();
        return await resp.Content.ReadAsByteArrayAsync(ct);
    }

    private async Task<byte[]> GetIconDocAllBinAsync(CancellationToken ct)
    {
        await EnsureAccessTokenAsync(ct);

View on GitHub (pinned to a7cb36712d)

Solutions

1. 检查网络连接，确认能正常访问空荧酒馆地图服务
2. 稍后重试，可能是服务端临时异常
3. 若持续失败，更新 BetterGI 或到社区反馈该接口问题

Example fix

稍后重试或检查网络；若持续报错，确认 BetterGI 版本与酒馆接口兼容并反馈服务端错误消息。

When it happens

Trigger: 请求空荧酒馆 marker_doc/list_page_bin_md5 接口，HTTP 成功但业务响应体 Error 为 true 时，携带服务端 Message 抛出。

Common situations: 酒馆服务端返回业务错误：token 失效、接口维护或请求参数不被接受。

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