Skip to content

Produce a warning when using const with interior mutability #40543

Closed

Description

@matklad

Originally reported in https://users.rust-lang.org/t/broken-atomics-puzzle/9533

Consider this code

use std::sync::atomic::{AtomicBool, Ordering};

pub const A: AtomicBool = AtomicBool::new(false);

fn main() {
    A.compare_exchange(false, true, Ordering::SeqCst, Ordering::SeqCst);
    println!("A = {}", A.load(Ordering::SeqCst));
}

Playground

It compiles and runs cleanly, but produces unexpected results because const is used instead of static.

It would be nice to somehow give a warning for .compare_and_swap call, but I am not sure it is possible.

Activity

  1. matklad commented on Mar 15, 2017

    @matklad
    ContributorAuthor

    Note that compare_and_swap uses &self:

    compare_and_swap(&self, current: bool, new: bool, order: Ordering) -> bool
  2. petrochenkov commented on Mar 15, 2017

    @petrochenkov
    Contributor

    The underlying issue is the same - A is a rvalue and copied on use and this becomes observable when any mutability is involved, interior or exterior.

  3. steveklabnik commented on Mar 15, 2017

    @steveklabnik
    Contributor

    New warnings generally require an RFC, but I'll let @rust-lang/compiler make the call

  4. added
    A-lintsArea: Lints (warnings about flaws in source code) such as unused_mut.
    T-compilerRelevant to the compiler team, which will review and decide on the PR/issue.
    on Mar 15, 2017
  5. nikomatsakis commented on Mar 16, 2017

    @nikomatsakis
    Contributor

    I'm not sure -- precisely what conditions would trigger the warning? I agree there is a subtle footgun at play here, if you don't understand the rules.

  6. matklad commented on Mar 16, 2017

    @matklad
    ContributorAuthor

    I'm not sure -- precisely what conditions would trigger the warning?

    I think "calling a method exploiting interior mutability on const" is the right condition, but I don't think we can really check it because we don't know which methods involve interior mutability.

  7. nikomatsakis commented on Mar 21, 2017

    @nikomatsakis
    Contributor

    Seems like it would have to "calling any method on const if the type of that const involves UnsafeCell", roughly speaking. Right?

  8. matklad commented on Mar 21, 2017

    @matklad
    ContributorAuthor

    Seems like it would have to "calling any method on const if the type of that const involves UnsafeCell", roughly speaking. Right?

    Yep. Perhaps this won't add false positives in practice?

    I wonder if we need to warn about creating constants with interior mutability. This is the root of the problem. Currently we need such constants for ATOMIC_X_INIT, but it is only because there are no constant functions in Rust yet.

  9. added
    C-bugCategory: This is a bug.
    C-feature-requestCategory: A feature request, i.e: not implemented / a PR.
    and removed
    C-bugCategory: This is a bug.
    on Jul 27, 2017
  10. Diggsey commented on Sep 13, 2017

    @Diggsey
    Contributor

    I'm not sure that's quite right:

    Seems to me like this behaviour occurs whenever an internally mutable rvalue is borrowed. However, it's only surprising when that rvalue comes from a constant, because constants don't look like rvalues, and because they can be used multiple times, whereas most rvalues can only be used once.

    Putting that together, it looks like the compiler should issue a warning whenever a constant containing an UnsafeCell is borrowed.

  11. burdges commented on Jan 19, 2018

    @burdges

    Another autotrait would be required for this, no? All atomics have this problem, but maybe not all usages of UnsafeCell? Also variance matters, like a &AtomicBool or &Arc<T> sounds okay.

    Also, there are usages for const fn with smart pointer, like Mutex/Arc::new() should become const fn so that statics containing Arcs can be initialized at compile time, meaning you'll transiently have a const with an Atomic and/or UnsafeCell during compilation.

  12. 9 remaining items

  13. PatchMixolydic commented on Aug 11, 2022

    @PatchMixolydic
    Contributor

    Clippy has two lints for this situation: clippy::declare_interior_mutable_const and clippy::borrow_interior_mutable_const. Since this seems to be a common stumbling block and there don't seem to be many reasons for placing an interior mutable value in a const, I believe this lint should probably be lifted into rustc.

  14. mitsuhiko commented on Aug 12, 2022

    @mitsuhiko
    Contributor

    Now that Mutex has a const ctor this is more likely to trip up people. It has come up more than once in the discussions of the announcement post. If this lint is lifted it would probably be nice if types gain an attribute similar to #[must_use] on functions so that user code can also annotate this. An alternative would be not to warn on the declaration but when someone tries to do something like acquire (thus adding the annotation to the methods instead).

  15. jplatte commented on Aug 12, 2022

    @jplatte
    Contributor

    Yeah, an opt-in or opt-out would be nice. The clippy lint is pretty useful, but sometimes it's also unhelpful, for example when storing the result of http::header::HeaderName::from_static in a const such that the compiler guarantees its validity.

  16. bbqsrc commented on Apr 25, 2023

    @bbqsrc

    This too has hit me now.

  17. vultix commented on May 7, 2023

    @vultix

    I accidentally ran into this when using a OnceCell, accidentally reinitializing my type each call due to const instead of static. This is certainly an easy footgun to run into

  18. quaternic commented on Jun 16, 2023

    @quaternic
    Contributor

    I've previously hit and reported a false positive (rust-lang/rust-clippy#7665) with the clippy lint clippy::declare_interior_mutable_const.

    In short, when [Cell::new(true); 7] fails as the type is not Copy, rustc correctly suggests this fix:

    const TRUE_CELL: Cell<bool> = Cell::new(true);
    let _: [Cell<bool>; 7] = [TRUE_CELL; 7];
    

    However, this code triggers the clippy lint, and even gives the incorrect suggestion to change the const to a static.

    I did just learn that since 1.63 we've had this cleaner alternative:

    let array: [Cell<bool>; 7] = std::array::from_fn(|_| Cell::new(true));
    

    Either way, the relevant question I was wondering about in that issue:

    The example in the documentation also triggers borrow_interior_mutable_const, so it's not clear why this lint is needed in addition. In fact, it seems to me that any attempt to mutate the const requires a shared reference and triggers borrow_interior_mutable_const. If there is no such attempt, the interior mutability is inconsequential.

    Are there cases where an interior mutable const is never used by reference (e.g. by calling Once::call_once), but the lint would still be useful?

  19. added 4 commits that reference this issue on Nov 22, 2025
  20. added a commit that references this issue on Nov 22, 2025
  21. added a commit that references this issue on Jan 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    A-lintsArea: Lints (warnings about flaws in source code) such as unused_mut.C-feature-requestCategory: A feature request, i.e: not implemented / a PR.T-compilerRelevant to the compiler team, which will review and decide on the PR/issue.

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions