XX-net/XX-Net · error

download file %s fail.

Error message

download file %s fail.

What it means

download_unzip reports that its inner download_file call failed for the given archive URL, then returns without extracting. The GAE library (e.g. openssl/goagent libs) is therefore not installed.

Source

Thrown at code/default/gae_proxy/local/download_gae_lib.py:113

            xlog.warn("download %s to %s fail:%r", org_url, filename, e)
            continue
    xlog.warn("download %s fail", org_url)


def download_unzip(url, extract_path):
    if os.path.isdir(extract_path):
        return True

    data_root = os.path.join(top_path, 'data')
    download_path = os.path.join(data_root, 'downloads')
    if not os.path.isdir(download_path):
        os.mkdir(download_path)

    fn = url.split("/")[-1]
    dfn = os.path.join(download_path, fn)

    if not download_file(url, dfn):
        xlog.warn("download file %s fail.", url)
        return

    try:
        os.mkdir(extract_path)
        with zipfile.ZipFile(dfn, "r") as dz:
            dz.extractall(extract_path)
            dz.close()
        xlog.info("Extract %s to %s success.", fn, extract_path)
    except Exception as e:
        xlog.warn("unzip %s fail:%r", dfn, e)
        shutil.rmtree(extract_path)
        raise e
    os.remove(dfn)


def check_lib_or_download():
    lib_path = os.path.abspath(os.path.join(current_path, os.pardir, "server", "lib"))

View on GitHub (pinned to cfa5bc17b6)

Solutions

  1. Restore network/proxy connectivity and restart so check_lib_or_download runs again
  2. Manually download the archive and extract it to extract_path so the isdir() check short-circuits
  3. Check the preceding xlog lines for the underlying network error
Defensive patterns

Strategy: fallback

Validate before calling

import os
# skip download when already extracted
done = os.path.isdir(extract_path)

Prevention

When it happens

Trigger: check_lib_or_download() -> download_unzip(url, extract_path) where download_file returns False (all retries exhausted).

Common situations: First launch without network, blocked download host, corporate proxy blocking the archive URL.

Related errors

AI-assisted analysis of XX-net/XX-Net@cfa5bc17b6 (2026-08-27). Data as JSON: /api/errors/e3a52f659d5c1113. Report an issue: GitHub.