Windows命令行运行Swift REPL触发断言崩溃报错问题求助

环境配置与问题复现 #

• 参照Swift官方入门文档操作，已在Visual Studio中安装Swift及全部依赖组件，安装详情如下：
  
• 已将Python 3.9添加至系统PATH环境变量（官方指南指定依赖Python 3.7版本，暂未确认版本差异是否影响运行），路径配置执行命令如下：

path %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Python39_64;%PATH%

• 配置SWIFTFLAGS参数传入REPL运行所需的额外编译参数，执行的REPL启动命令如下：

set SWIFTFLAGS=-sdk %SDKROOT% -I %SDKROOT%/usr/lib/swift -L %SDKROOT%/usr/lib/swift/windows
swift repl -target x86_64-unknown-windows-msvc %SWIFTFLAGS%

• 执行上述命令后REPL可正常启动，显示欢迎界面如下：

Welcome to compnerd.org Swift version 5.6.2 (swift-5.6.2-RELEASE).
Type :help for assistance.
1>

• 输入测试表达式1 + 2验证功能时直接触发崩溃，报错信息如下：

Assertion failed: false && "called into swift language runtime stub", file D:\a\1\s\llvm-project\lldb\source\Plugins\LanguageRuntime\Swift\SwiftLanguageRuntime.cpp, line 369
PLEASE submit a bug report and include the crash backtrace.
 #0 0x00007ff739ced645 (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\lldb.exe+0x1d645)
 #1 0x00007ffc6eeb1881 (C:\WINDOWS\System32\ucrtbase.dll+0x71881)
 #2 0x00007ffc6eeb2851 (C:\WINDOWS\System32\ucrtbase.dll+0x72851)
 #3 0x00007ffc6eeb426e (C:\WINDOWS\System32\ucrtbase.dll+0x7426e)
 #4 0x00007ffc6eeb4165 (C:\WINDOWS\System32\ucrtbase.dll+0x74165)
 #5 0x00007ffc6eeb44f1 (C:\WINDOWS\System32\ucrtbase.dll+0x744f1)
 #6 0x00007ffbf02aa1d5 PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x83a1d5)
 #7 0x00007ffbf525f724 PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x57ef724)
 #8 0x00007ffbf5265031 PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x57f5031)
 #9 0x00007ffbf52628a2 PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x57f28a2)
#10 0x00007ffbf525cbcb PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x57ecbcb)
#11 0x00007ffbeffd7d2b PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x567d2b)
#12 0x00007ffbeffe6c52 PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x576c52)
#13 0x00007ffbeffb4806 PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x544806)
#14 0x00007ffbeff6265a PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x4f265a)
#15 0x00007ffbeff6106e PyInit__lldb (C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\bin\liblldb.dll+0x4f106e)
#16 0x00007ffc6ee61bb2 (C:\WINDOWS\System32\ucrtbase.dll+0x21bb2)
#17 0x00007ffc70947034 (C:\WINDOWS\System32\KERNEL32.DLL+0x17034)
#18 0x00007ffc713a2651 (C:\WINDOWS\SYSTEM32\ntdll.dll+0x52651)

• 已尝试操作：卸载重装相关组件、调整启动参数，问题未解决。

排查修复步骤 #

按以下优先级依次排查：

1. 修复Python版本不匹配问题
   Swift 5.6 Windows工具链内置的LLDB硬编码依赖Python 3.7，Python 3.9与3.7 ABI不兼容，会直接导致LLDB加载Swift运行时插件时触发断言。移除当前PATH中配置的Python39路径，安装Python 3.7.x 64位版本，重新配置PATH后启动REPL测试。
2. 校验SDKROOT环境变量配置
   启动REPL前先确认SDKROOT变量值有效，该变量需指向Windows SDK的对应安装路径，默认路径格式为C:\Program Files (x86)\Windows Kits\10\bin\<已安装的SDK版本号>\x64，变量为空会导致编译参数传入无效，运行时找不到Swift对应库而触发桩函数调用断言。配置示例：

   set SDKROOT=C:\Program Files (x86)\Windows Kits\10\bin\10.0.19041.0\x64
   

3. 补全REPL启动参数
   现有SWIFTFLAGS参数缺失Swift运行时库的链接路径配置，补充Swift工具链的库路径参数，确保REPL执行JIT编译时能正确链接Swift核心运行时库，不会调用空桩函数。修正后的完整启动命令：

   set SWIFTFLAGS=-sdk %SDKROOT% -I %SDKROOT%/usr/lib/swift -L %SDKROOT%/usr/lib/swift/windows -L "C:\Library\Developer\Toolchains\unknown-Asserts-development.xctoolchain\usr\lib\swift\windows"
   swift repl -target x86_64-unknown-windows-msvc %SWIFTFLAGS%
   

4. 升级工具链版本
   5.6版本的Windows Swift工具链属于早期移植版本，REPL功能本身存在已知稳定性缺陷。若上述操作后仍崩溃，直接升级到5.8及以上正式发布版本，新版本已修复大量Windows平台下LLDB与Swift运行时交互的断言问题，无需手动配置复杂SWIFTFLAGS参数即可正常启动REPL。

工具链有效性快速验证：如果暂时不需要使用REPL交互环境，可先通过swiftc编译单文件验证核心功能是否正常。编写print(1+2)保存为test.swift，执行swiftc test.swift -o test.exe后运行生成的exe文件，若正常输出3则说明工具链核心功能正常，崩溃仅为REPL组件的配置或版本兼容问题。

内容的提问来源于stack exchange，提问作者Omaro_IB