FreeBSD环境下Vulkan实例创建时出现段错误的原因排查

最小复现代码 #

#include <vulkan/vulkan.h>
#include <iostream>

int main()
{
  VkApplicationInfo info{};
  info.sType = VK_STRUCTURE_TYPE_APPLICATION_INFO;
  info.pNext = nullptr;
  info.apiVersion = VK_VERSION_1_3;
  info.applicationVersion = 1;
  info.engineVersion = 0;
  info.pApplicationName = "App";
  info.pEngineName = nullptr;

  VkInstanceCreateInfo instanceInfo{};
  instanceInfo.sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO;
  instanceInfo.pNext = nullptr;
  instanceInfo.flags = 0;
  instanceInfo.enabledExtensionCount = 0;
  instanceInfo.enabledLayerCount = 0;
  instanceInfo.ppEnabledExtensionNames = nullptr;
  instanceInfo.ppEnabledLayerNames = nullptr;
  instanceInfo.pApplicationInfo = &info;

  VkInstance instance;
  auto code = vkCreateInstance(&instanceInfo, nullptr, &instance);

  if (code != VK_SUCCESS)
  {
    std::cout << "failed to create instance" << std::endl;
    return -1;
  }
  else vkDestroyInstance(instance, nullptr);
  return 0;
}

环境信息 #

• 系统：FreeBSD 13.2
• 编译器：Clang 16.0.6
• 已安装的Vulkan相关包：

$ pkg info vulkan*
vulkan-caps-viewer-3.31
vulkan-extension-layer-1.3.254
vulkan-headers-1.3.254
vulkan-loader-1.3.254
vulkan-tools-1.3.254
vulkan-validation-layers-1.3.254

调试信息 #

添加调试符号后通过GDB调试，得到以下输出：

Program received signal SIGSEGV, Segmentation fault.
Address not mapped to object.
0x0000000800595300 in ?? () from /lib/libc.so.7
(gdb) backtrace
#0  0x0000000800595300 in ?? () from /lib/libc.so.7
#1  0x00000008005a04b6 in vsnprintf () from /lib/libc.so.7
#2  0x00000008002e3dec in ?? () from /usr/local/lib/libvulkan.so.1
#3  0x00000008002c1278 in ?? () from /usr/local/lib/libvulkan.so.1
#4  0x00000008002ded9f in ?? () from /usr/local/lib/libvulkan.so.1
#5  0x00000008002e1579 in ?? () from /usr/local/lib/libvulkan.so.1
#6  0x00000008002e7ca6 in vkCreateInstance () from /usr/local/lib/libvulkan.so.1
#7  0x000000000020b569 in main () at /home/chris/projects/freestick/src/main.cpp:26
(gdb) frame 7
#7  0x000000000020b569 in main () at /home/chris/projects/freestick/src/main.cpp:26
26    auto code = vkCreateInstance(&instanceInfo, nullptr, &instance);
(gdb) p instanceInfo
$1 = {sType = VK_STRUCTURE_TYPE_INSTANCE_CREATE_INFO, pNext = 0x0, flags = 0, pApplicationInfo = 0x7fffffffe6f8, enabledLayerCount = 0, 
  ppEnabledLayerNames = 0x0, enabledExtensionCount = 0, ppEnabledExtensionNames = 0x0}

问题 #

调用vkCreateInstance时触发段错误，无法成功创建Vulkan实例。

解决方向 #

1. 验证系统Vulkan基础环境：先执行vulkaninfo命令，若该命令崩溃或无有效输出，说明系统层面缺少可用的Vulkan物理设备，需检查显卡驱动（NVIDIA/AMD闭源驱动或Mesa开源驱动）是否正确安装并启用Vulkan支持。
2. 降低API版本尝试：将代码中的info.apiVersion改为VK_VERSION_1_0或VK_VERSION_1_1，部分旧驱动对Vulkan 1.3的支持可能存在兼容性问题。
3. 确认编译链接参数：编译时需确保链接Vulkan库，使用如下命令编译：

   clang++ -g -o vulkan_test main.cpp -lvulkan
   

4. 检查驱动与loader版本匹配：当前vulkan-loader版本为1.3.254，需确认显卡驱动的Vulkan版本与之兼容，必要时更新驱动或loader包。
5. 显式初始化所有结构体字段：虽然代码已用{}做值初始化，但可尝试显式赋值所有字段，避免因编译器差异导致的未初始化内存问题（当前代码初始化逻辑合规，此为兜底尝试）。

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