Windows下默认浏览器为Firefox时GTK3无法打开本地HTML文件

在Windows上使用MSYS2（ucrt64）编译GTK3程序时，调用gtk_show_uri_on_window()或g_app_info_launch_default_for_uri()打开本地HTML文件，IE/Edge可正常执行，但Firefox会失败。原因是传递的file:///C:/path/to/file.html被转为Windows本地路径C:\path\to\file.html，Firefox误将盘符C:识别为未知协议，报错信息如下：

无法理解此地址
Firefox不知道如何打开此地址，因以下协议之一（c）未关联程序或不被允许。

若Firefox已处于打开状态，程序会将路径字符串当作搜索内容而非打开目标文件。手动替换路径中的斜杠为反斜杠也无效果，导出的URI仍会使用斜杠。该问题仅在Windows平台出现，Linux/macOS下无此异常。

当前使用的C代码片段：

{
    MyAppWindow *window = (MyAppWindow *)user_data;
    gchar *filename = NULL;
    gchar *url = NULL;
    const gchar * const *dirs = g_get_system_data_dirs();
    GError *error = NULL;

    while (*dirs != NULL) {
        filename = g_build_filename(*dirs++, "path", "to", "file.html", NULL);
        if (g_file_test(filename, G_FILE_TEST_EXISTS)) {
            url = malloc((strlen(filename) + 9) * sizeof(gchar));
            strcpy(url, "file:///");
            strcat(url, filename);
            gtk_show_uri_on_window(GTK_WINDOW(window), url, GDK_CURRENT_TIME, &error);
            if (error != NULL) {
                fprintf (stderr, "Error: %s\n", error->message);
                g_error_free (error);
            }
            if (url != NULL)
                g_free(url);
            if (filename != NULL)
                g_free(filename);
            break;
        }
    }
}

问题根源在于手动拼接file:///前缀的方式不符合Windows平台的URI规范，正确做法是使用GLib提供的g_filename_to_uri()函数生成标准file URI，该函数会自动处理Windows盘符、路径分隔符等平台差异，生成所有主流浏览器都能识别的合法URI。

修改后的代码片段：

{
    MyAppWindow *window = (MyAppWindow *)user_data;
    gchar *filename = NULL;
    gchar *url = NULL;
    const gchar * const *dirs = g_get_system_data_dirs();
    GError *error = NULL;

    while (*dirs != NULL) {
        filename = g_build_filename(*dirs++, "path", "to", "file.html", NULL);
        if (g_file_test(filename, G_FILE_TEST_EXISTS)) {
            // 使用GLib函数生成标准file URI
            url = g_filename_to_uri(filename, NULL, &error);
            if (error != NULL) {
                fprintf(stderr, "Error converting filename to URI: %s\n", error->message);
                g_error_free(error);
                g_free(filename);
                break;
            }
            
            gtk_show_uri_on_window(GTK_WINDOW(window), url, GDK_CURRENT_TIME, &error);
            if (error != NULL) {
                fprintf(stderr, "Error opening URI: %s\n", error->message);
                g_error_free(error);
            }

            g_free(url);
            g_free(filename);
            break;
        }
    }
}

关键说明 #

• g_filename_to_uri()会将Windows本地路径（如C:\path\to\file.html）转换为符合RFC标准的file URI：file:///C:/path/to/file.html，该格式可被Firefox、Edge、IE等所有主流浏览器正确识别。
• 避免手动拼接URI，手动处理路径分隔符、盘符等细节易出错，GLib函数已封装完善的平台适配逻辑。
• 函数第二个参数用于指定URI的主机部分，本地文件场景传入NULL即可。

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