codecov/codecov-action "failed to properly upload report"

By Daniel Zoghalchali·Latchkey

codecov-action uploads coverage to Codecov. A transient network error, an upstream 5xx, or a missing token on private repos can fail the upload after tests pass.

What this error means

The codecov step fails with "failed to properly upload report" though tests and coverage generation succeeded.

['error'] There was an error running the uploader: Error uploading to ...
failed to properly upload report
##[error]Codecov: Failed to properly upload report

Common causes

Transient upload failure

A momentary network error or Codecov 5xx interrupts the upload.

Missing token on private repo

Private repos require CODECOV_TOKEN; without it the upload is rejected.

How to fix it

Supply the token and tolerate transient flakes

1. Set the token input to secrets.CODECOV_TOKEN for private repos.
2. Set fail_ci_if_error thoughtfully so a transient flake does not always fail CI.
3. Re-run for transient upload errors.

- uses: codecov/codecov-action@v4
  with:
    token: ${{ secrets.CODECOV_TOKEN }}
    files: ./coverage/lcov.info

How to prevent it

• Provide CODECOV_TOKEN for private repositories.
• Latchkey managed runners auto-retry transient upload failures to coverage services, so an intermittent Codecov upload error usually clears on retry.

Frequently asked questions

Related guides

References

• GitHub Actions documentation
• Workflow syntax for GitHub Actions