Android端Flutter用launchUrl打开PHP生成PDF遇白屏求助

问题本质 #

直接访问PDF文件时，系统能识别文件类型并调用对应应用处理；但PHP生成PDF的动态链接，若服务器返回的HTTP头配置不当，会导致Android系统无法直接识别内容类型，进而出现白屏。当前用externalApplication能触发下载，是因为系统将其当作普通下载链接处理。

可行解决方案 #

1. 修正PHP接口的响应头配置 #

先确保生成PDF的PHP接口返回正确的HTTP头，让系统识别这是可直接打开的PDF内容：

// PHP代码示例：添加正确的响应头
header('Content-Type: application/pdf');
// 用inline告知浏览器尝试直接打开，而非强制下载
header('Content-Disposition: inline; filename="generated.pdf"');

// 若需同时支持下载和打开，可根据请求参数切换Disposition
// 比如接收?action=open就用inline，?action=download就用attachment

2. 调整Flutter的launchUrl参数 #

根据需求选择合适的启动模式，配合服务器头实现直接打开：

• 用默认PDF应用打开：

Uri uri = Uri.parse(url);
if (await canLaunchUrl(uri)) {
  await launchUrl(
    uri,
    mode: LaunchMode.externalNonBrowserApplication,
  );
}

此模式会跳过浏览器，直接调用系统默认的PDF阅读器打开链接（前提是服务器头配置正确）。

• 用浏览器打开：
  保持externalApplication模式，但需确保浏览器能解析PHP返回的PDF内容（依赖服务器的inline头配置）。若浏览器仍白屏，可尝试添加WebView配置（仅针对inAppWebView模式）：

await launchUrl(
  uri,
  mode: LaunchMode.inAppWebView,
  webViewConfiguration: const WebViewConfiguration(
    enableJavaScript: true,
    allowInlineMediaPlayback: true,
  ),
);

总结 #

核心是让PHP接口返回Content-Type: application/pdf和Content-Disposition: inline头，再配合对应launchUrl模式，就能实现直接在浏览器或默认PDF应用中打开动态生成的PDF，避免白屏或强制下载的问题。

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