android 系统自始至终要求打印操作必须在 activity 上下文中执行，service 中使用 context.getsystemservice(context.print_service) 会因缺少 ui 线程和窗口令牌而抛出 illegalstateexception，该限制在 android 11 及更高版本中依然严格存在。
在 Android 中，PrintManager 并非一个纯后台服务接口，而是深度依赖 Activity 的生命周期与窗口环境（如 WindowManager、Token 和 Looper）。即使在 Android 11（API 30）及后续版本（如 Android 12–14），这一设计原则未被放宽——系统明确禁止从 Service、BroadcastReceiver 或 Application Context 中触发打印任务。你遇到的 IllegalStateException: Can print only from an activity 正是框架层的强制校验结果，而非兼容性 Bug。
✅ 正确实现方式：将打印委托给 Activity
你需要将打印逻辑“回调”至前台 Activity。推荐采用以下两种健壮方案：
方案一：通过 LocalBroadcastManager 或 LiveData 通知 Activity（推荐）
在 Service 中完成 PDF 准备后，发送广播或更新共享状态，由已启动的 Activity 执行实际打印：
// 在 Service 中（例如 MyPrintService.java）
private void notifyPrintReady(String pdfPath) {
Intent intent = new Intent("ACTION_PRINT_READY");
intent.putExtra("pdf_path", pdfPath);
LocalBroadcastManager.getInstance(this).sendBroadcast(intent);
}// 在宿主 Activity 中（例如 MainActivity.java）
private BroadcastReceiver printReceiver = new BroadcastReceiver() {
@Override
public void onReceive(Context context, Intent intent) {
String path = intent.getStringExtra("pdf_path");
if (path != null) {
triggerPrintFromActivity(path); // ✅ 使用 Activity.this 作为 Context
}
}
};
private void triggerPrintFromActivity(String pdfPath) {
PrintManager printManager = (PrintManager) this.getSystemService(Context.PRINT_SERVICE);
PrintDocumentAdapter adapter = new PdfDocumentAdapter(pdfPath);
String jobName = getString(R.string.app_name) + "_print_job";
printManager.print(jobName, adapter, new PrintAttributes.Builder().build());
}⚠️ 注意事项： 必须确保 Activity 处于 RESUMED 状态（即可见且可交互），否则 print() 仍可能失败；建议在 onResume() 中注册接收器，onPause() 中注销。 若应用处于后台（无前台 Activity），应暂停打印请求并提示用户“请返回应用以完成打印”。
方案二：使用 startActivityForResult（适用于需用户确认的场景）
若 Service 启动时 Activity 尚未就绪，可通过 startActivityForResult()（AndroidX 中推荐 registerForActivityResult()）跳转至专用打印 Activity，并在其 onCreate() 中立即执行打印：
// 在 Service 中启动打印界面
val intent = Intent(this, PrintActivity::class.java).apply {
flags = Intent.FLAG_ACTIVITY_NEW_TASK or Intent.FLAG_ACTIVITY_CLEAR_TOP
putExtra("pdf_path", pdfPath)
}
this.startActivity(intent)// PrintActivity.kt
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
val pdfPath = intent.getStringExtra("pdf_path")
if (!pdfPath.isNullOrBlank()) {
printPdf(pdfPath) // ✅ this 是 Activity Context，完全合法
}
}❌ 常见误区与禁用方案
- 不要尝试使用 getApplicationContext() 或 Service.this 强转为 Activity：这会导致 NullPointerException 或运行时崩溃。
- 不建议使用 WindowManager 或反射绕过限制：违反 Android 沙箱机制，高版本系统（尤其是 Android 12+）会静默拦截或触发 SecurityException。
- 避免在 Foreground Service 中“模拟” Activity 上下文：无法提供有效的 Display 和 InputChannel，打印预览界面将无法渲染。
总结
Android 的打印 API 设计本质是面向用户交互的 UI 功能，而非后台任务。无论目标 SDK 是 30（Android 11）还是 34（Android 14），都必须遵守“仅 Activity 可发起打印”的契约。最佳实践是解耦「数据准备」（可在 Service 完成）与「UI 执行」（交由 Activity 完成），通过松耦合通信机制协同工作——既符合平台规范，也保障了稳定性和用户体验。
