Wayland平台下Vulkan调用vkCmdBeginRenderPass时程序挂起求助

我正在Wayland平台上学习Vulkan教程，这是一个将wayland-egl和OpenGL ES 3移植到Vulkan的项目。前面所有步骤都正常，但在最终的绘制帧函数中遇到了问题：录制命令缓冲区时，调用vkCmdBeginRenderPass函数后程序无返回，直接阻塞。我的完整源码在指定仓库提交中（可忽略图像加载函数和wl_output监听器），需求只是在Wayland表面绘制三角形，已搜索相关关键词但未找到解决办法，请问问题出在哪里？为何程序会在vkCmdBeginRenderPass处挂起？

可能的原因及排查步骤 #

1. Render Pass与Framebuffer不匹配 #

vkCmdBeginRenderPass要求Render Pass配置和绑定的Framebuffer完全兼容，需重点检查：

• Render Pass的attachmentDescription中的格式、样本数，是否与Swapchain图像格式、创建参数完全一致
• Framebuffer的宽/高度是否和当前Swapchain图像的实际尺寸匹配——Wayland表面尺寸可能在初始化后动态变化，需确保Framebuffer基于实时尺寸创建

2. 命令缓冲区录制状态异常 #

• 确认vkBeginCommandBuffer调用成功，命令缓冲区处于可录制状态
• 检查命令缓冲区级别（primary/secondary）是否符合Render Pass使用要求：secondary命令缓冲区在Render Pass内使用需额外配置参数

3. Wayland Swapchain图像同步问题 #

• 录制命令缓冲区前，必须通过vkAcquireNextImageKHR成功获取Swapchain图像，且对应的同步信号（如semaphore）已正确设置
• 排查是否未正确等待必要的同步对象，导致GPU资源未就绪，引发阻塞

4. Render Pass Subpass配置错误 #

• 检查Subpass的依赖关系：srcStageMask和dstStageMask设置错误可能导致GPU死锁
• 确认Subpass的attachment引用索引正确，避免引用不存在的attachment

5. 队列族与命令缓冲区不匹配 #

• 确保命令缓冲区在兼容的队列族上创建：Wayland平台下Vulkan队列族需同时支持图形操作和演示（present）能力

针对你代码的具体排查建议 #

从你提供的源码来看，可优先检查：

• create_render_pass函数中，attachment格式是否与vkGetPhysicalDeviceSurfaceFormatsKHR获取的Swapchain图像格式一致
• create_framebuffers函数中，是否使用了Wayland表面的实时尺寸创建Framebuffer，而非固定值
• record_command_buffer函数中，vkCmdBeginRenderPass的pBeginInfo参数里，framebuffer是否正确绑定了当前获取到的Swapchain图像对应的Framebuffer
• 同步对象的使用逻辑：录制命令缓冲区前是否正确等待vkAcquireNextImageKHR返回的semaphore

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