← Rule catalog

Clippy · Maintainability

Async function that never awaits

clippy::unused_async

Remove the async marker, or await the work the function was meant to drive.

Category
Maintainability
Default level
warn
Tier
P3
Producer
Clippy
Diff scope
item

Not a defect when

The function must be async to satisfy an interface, such as a web framework handler, a callback expecting a future or a function pointer type.

What it reads

Clippy, with the compiler behind it. The only pass that compiles.

Tier

Lowest tier: real, and rarely urgent.

The tier bounds how severe a rule may be; its category bounds the tier.

Diff scope

The function or item around the changed line.

What --scope contextual looks at to decide whether a change caused the finding.

Change it

Turn it off, or make it blocking, without touching the code it flags:

rust-doctor --rule clippy::unused_async=off .
rust-doctor --rule clippy::unused_async=error .

Set it once in rust-doctor.toml

Upstream

Clippy's own documentation for this lint

Other Maintainability rules