# Troubleshooting

Keep the exact command, CLI revision, compiler version, stdout report, stderr and exit code. Start with a minimal input that reproduces the issue.

## The CLI is not available

This pre-prod uses restricted access. Request a checkout from the owner who provided access; there is no public download link. Follow [Installation](https://docs.swift-analyzer.com/get-started/installation/) and keep the binary's resource bundles beside it.

## source-scan requires --allow-build

The flag is an explicit authorization boundary. The command evaluates Package.swift, may retrieve locked Git dependencies and performs an indexed build. Review the input, then provide the flag if you intend those actions.

## The report says unavailable

Read `reasons`. `unsupported-resource-census` and `unsupported-resource-rule` identify the tutorial's deliberately unsupported resource input. Reduce the input or use an admitted form; removing a limitation from the JSON does not change admission.

`source-count`, `module-count`, `authored-generated-source-count`, `source-file-bytes` or `source-bytes` reasons mean the bounded envelope was exceeded. Select a small supported product. A full scan of this analyzer repository is not currently supported by the documented workflow.

## The report says degraded with zero findings

Check `conditions` and `families`. Unknown observations, missing source effects, native effects or families with no observations prevent a clean interpretation. The tutorial control intentionally demonstrates this case. See [Understand results](https://docs.swift-analyzer.com/guides/results/).

## A build or toolchain step fails

Verify `xcrun swift --version`, the selected developer tools, package access and locked dependency state. Do not point the analyzer at a different compiler's Index Store and assume compatibility. Preserve acquisition reasons when asking the owner for help.

## An existing Index Store is rejected

A raw Index Store is not the manifest-backed immutable snapshot required by `doctor`, `stats`, `scan` or `why`. Ask its supplier for the complete admitted bundle and profile, or use [source-scan](https://docs.swift-analyzer.com/guides/swiftpm/) for a supported product.

## Report a documentation mismatch

Include the page URL, visible product revision, exact command and observed outcome. Share the smallest relevant source example through the project's existing owner contact. Remove unrelated source, credentials and machine-local paths before sharing. No automated source-upload service is part of these docs.


---

Language: en
Canonical: https://docs.swift-analyzer.com/guides/troubleshooting/
Product revision: 524fa07e0ae4153c84ac12ae9eb6559df89ec2be
Catalog revision: 4558458d
Documentation digest: 1f17ba58ab08627e0de898f1442067b09e960b48cd5605d6529e9275f8930d68
Channel: pre-prod; maturity: experimental; access: owner-provided checkout.