WebKitGTK6网页转PDF失败：无回调触发且未生成文件

可能的原因及解决步骤 #

• 检查打印设置的初始化完整性
  确保创建WebKitPrintSettings时正确指定PDF格式与绝对输出路径，WebKit不会自动解析~/这类波浪号路径：

  WebKitPrintSettings *print_settings = webkit_print_settings_new();
  webkit_print_settings_set_output_format(print_settings, WEBKIT_PRINT_FORMAT_PDF);
  // 手动展开为绝对路径
  gchar *abs_path = g_strdup_printf("%s/Documents/simple.pdf", g_get_home_dir());
  webkit_print_settings_set_output_path(print_settings, abs_path);
  g_free(abs_path);
  

• 确认回调信号绑定正确性
  检查print-finished、print-failed信号是否在打印操作前完成绑定，注意信号名称为小写连字符格式，且绑定的web_view对象未提前释放：

  g_signal_connect(web_view, "print-finished", G_CALLBACK(print_finished_cb), user_data);
  g_signal_connect(web_view, "print-failed", G_CALLBACK(print_failed_cb), user_data);
  

• 等待网页完全加载后再触发打印
  若调用打印时网页未加载完成，可能导致静默失败。监听load-finished信号，在网页加载完成后执行打印：

  g_signal_connect(web_view, "load-finished", G_CALLBACK(on_load_finished), print_settings);
  
  static void on_load_finished(WebKitWebView *web_view, WebKitLoadEvent event, gpointer user_data) {
      if (event == WEBKIT_LOAD_FINISHED) {
          WebKitPrintSettings *settings = WEBKIT_PRINT_SETTINGS(user_data);
          webkit_web_view_print(web_view, settings, NULL);
      }
  }
  

• 验证目标目录权限
  检查~/Documents目录的读写权限，确保当前用户有权写入：

  gchar *docs_dir = g_build_filename(g_get_home_dir(), "Documents", NULL);
  if (!(g_file_test(docs_dir, G_FILE_TEST_IS_DIR) && g_file_test(docs_dir, G_FILE_TEST_WRITABLE))) {
      g_printerr("Documents目录不可写\n");
  }
  g_free(docs_dir);
  

• 查看WebKit调试日志
  启动程序时设置环境变量打印打印流程日志，定位具体问题：

  WEBKIT_DEBUG=Printing ./your_app
  

• 核对WebKitGTK6 API用法
  WebKitGTK6可能调整了打印相关API，尝试使用WebKitPrintOperation对象执行打印，替代直接调用webkit_web_view_print：

  WebKitPrintOperation *op = webkit_print_operation_new(web_view);
  webkit_print_operation_set_print_settings(op, print_settings);
  g_signal_connect(op, "finished", G_CALLBACK(print_op_finished), user_data);
  g_signal_connect(op, "failed", G_CALLBACK(print_op_failed), user_data);
  webkit_print_operation_run(op, WEBKIT_PRINT_OPERATION_ACTION_PRINT_DIALOG, NULL, NULL);
  

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