Troubleshooting

Allure HTML looks empty when opened from disk

Symptom: official allure-report-html/index.html shows loading placeholders or 404 inside tabs.

Cause: Allure SPA needs HTTP context for loading data files.

Fix:

allure open ./allure-report-out/allure-report-html

or run python -m http.server in that directory and open via http://localhost.

allure command not found

Install Allure CLI and ensure it is on PATH, then verify:

allure --version

Allure version validation fails

allure-report-exporter requires Allure Commandline 2.37.0 or newer.

Upgrade Allure or point to a specific binary:

allure-report build --allure-binary /path/to/allure ...

PDF generation fails due to missing browser

Install Playwright Chromium:

python -m playwright install chromium

For uv tool installs:

uvx playwright install chromium

Attachment files are missing

The exporter warns and continues when referenced attachment files do not exist.

Actions:

1. Confirm the allure-results folder includes the attachment files.
2. Regenerate Allure HTML with --clean.
3. Re-run report export.