Vulkan窗口Resize后vkAcquireNextImageKHR仅返回索引0的问题排查

核心原因 #

1. 交换链重建后，帧同步循环的状态（如swapchain_frame变量）未重置，导致复用旧交换链的同步资源状态，使得vkAcquireNextImageKHR无法正确获取第二个图像。
2. 代码中硬改图像索引的逻辑if (prev == *get_swapchain_image_index()) set_swapchain_image_index(1);完全错误——跳过Vulkan图像可用性校验直接指定索引，会触发VUID-VkPresentInfoKHR-pImageIndices-01296验证错误，且未解决根本问题。

解决方案 #

1. 交换链重建时强制重置帧状态 #

调用recreate_swapchain()时，必须重置帧循环索引（swapchain_frame）为0，同时重置或重新创建所有同步对象（信号量、Fence）。旧交换链的同步状态与新交换链无关，不重置会导致信号量与新交换链帧不匹配，引发图像获取异常。

2. 删除硬改图像索引的错误逻辑 #

直接移除if (prev == *get_swapchain_image_index()) set_swapchain_image_index(1);代码。Vulkan严格要求：只有通过vkAcquireNextImageKHR成功获取的图像索引，才能提交给vkQueuePresentKHR，否则会触发图像可用性校验错误。

3. 确保同步对象与当前交换链绑定 #

确认get_gpu_image_available()返回的信号量是为当前交换链创建的，或在交换链重建时重新生成同步对象。旧交换链的同步对象可能与新交换链的图像状态不兼容，导致获取逻辑异常。

4. 等待旧命令完成后再重建交换链 #

在销毁旧交换链前，等待所有旧渲染命令执行完成（通过Fence等待队列提交完成），确保旧交换链的所有图像都被正确释放，避免影响新交换链的图像获取。

修正后的代码示例 #

// 交换链重建函数内添加状态重置逻辑
void recreate_swapchain() {
    // 等待所有旧命令执行完成
    wait_for_all_fences();
    
    // 销毁旧交换链、同步对象
    destroy_old_swapchain();
    destroy_old_sync_objects();
    
    // 重建交换链与同步对象
    create_new_swapchain();
    create_new_sync_objects();
    
    // 重置帧循环索引
    swapchain_frame = 0;
}

// 获取交换链图像的修正代码
uint32_t image_index;
VkResult result = vkAcquireNextImageKHR(
    *get_hardware(),
    *get_swapchain(),
    1 SECOND,
    *get_gpu_image_available(swapchain_frame),
    VK_NULL_HANDLE,
    &image_index
);

set_swapchain_image_index(image_index);

if (result == VK_ERROR_OUT_OF_DATE_KHR) {
    recreate_swapchain();
    return; // 重建后跳过当前帧渲染，避免无效操作
} else if (result != VK_SUCCESS && result != VK_SUBOPTIMAL_KHR) {
    throw_error(true, "\nERROR: Acquisition of current frame's swapchain image failed.\n       The returned result is '" + get_result_string(result) + "'.");
}

// 推进帧循环索引，用于下一次获取对应信号量
swapchain_frame = (swapchain_frame + 1) % 2;

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