我太懂这种IDE误报的糟心感了——明明代码编译运行全正常，编辑器却硬要标个红给你添堵！针对你遇到的@OptionalExpectation相关的错误提示，我整理了几个实用的解决办法，你可以按需尝试：

1. 精准屏蔽单个元素的特定检查 #

这是最推荐的方式，只针对你这处PhoneNumber类的误报生效，完全不影响IDE对其他代码的正常检查。直接在类上添加Kotlin的抑制注解，指定要忽略的错误ID即可：

@Suppress("OPTIONAL_EXPECTATION_USAGE_IN_NON_COMMON_SOURCE")
@JvmInline value class PhoneNumber private constructor(val value: String) {
    init {
        require(value.matches(Regex("""^\+[1-9]\d{1,14}$"""))) { 
            "Phone number must be in E.164 format with a leading '+' " 
        }
    }
    // 你的其他类方法...
}

2. 全局关闭该类型的误报检查 #

如果项目里多处出现这个相同的误报，不想挨个加注解，也可以直接在IDE设置里关掉这个检查规则：

• 打开IntelliJ的设置（Windows/Linux用快捷键Ctrl+Alt+S，Mac用Cmd+,）
• 在设置页面搜索“Inspections”，进入代码检查配置界面
• 在检查项的搜索框里输入“OptionalExpectation usage in non-common source”，找到对应的检查条目
• 取消勾选这个条目，点击“Apply”保存设置
  这样整个IDE就不会再触发这个类型的误报了，不过记得别误关了其他对你有用的检查规则哦。

3. 临时忽略整个文件的该类检查（谨慎使用） #

要是你只是想快速让当前文件的红色提示消失，也可以在文件顶部添加文件级别的抑制注解：

@file:Suppress("OPTIONAL_EXPECTATION_USAGE_IN_NON_COMMON_SOURCE")

// 下面是你的PhoneNumber类和其他代码...

不过这种方式会忽略整个文件里的该类型错误，除非万不得已，不建议常用，免得掩盖了真正的代码问题。

另外你提到在官方追踪平台看到过相关的开放bug，这种误报大多是因为IDE的检查逻辑和你项目的Java21专属适配场景不同步导致的。如果上面的方法都暂时解决不了，也可以等IDE的后续版本更新，官方应该会修复这个适配问题。

内容来源于stack exchange