android
系统从设计上禁止在 service（包括前台/后台服务）中直接调用 printmanager 打印，因为 printmanager 要求必须使用 activity 的 context，否则会抛出 illegalstateexception：“can print only from an activity”。该限制在 android 11（api 30）及更高版本中依然严格生效，并非 bug，而是系统安全与用户体验的强制约束。
在 Android 中，打印流程本质上是
用户交互敏感操作
——它需要显示系统打印对话框（如选择
打印机
、设置页数、预览等），而这些 UI 组件只能安全地依附于 Activity 的生命周期和窗口令牌（Window Token）。Service 没有 UI 上下文，无法承载此类界面交互，因此即使你持有应用 Context 或 Application Context，调用 getSystemService(Context.PRINT_SERVICE) 获取的 PrintManager 实例在执行 print() 时仍会校验调用者是否为 Activity Context，并在失败时明确抛出 IllegalStateException。
✅ 正确做法：将打印逻辑
移回 Activity 层
你需要重构架构，确保打印触发点位于 Activity 内。常见推荐模式如下：
Trae win
Trae Windows 官方版本现已全面支持 Win10 和 Win11 系统（64位）。国内开发者可直接访问 Trae 中文官网（trae.cn 或 trae.com.cn），一键下载官方正版 .exe 安装包，享受国内直连的高速稳定体验。安装过程极其简便，双击即可运行，并支持一键无缝导入 VS Code 或 Cursor 的原有主题、快捷键及插件配置。登录支持手机号、微信或稀土掘金账号。内置免费的豆包与 DeepSeek 等顶级大模型，让你开箱即用，轻松开启高效的 AI 智能编程之旅。
下载
由 Activity 主动发起打印
（推荐）
将 PDF 路径通过 Intent、LiveData、EventBus 或 Callback 传递给 Activity，再在其内执行打印：
若需从 Service 触发（如后台完成 PDF 生成后通知用户打印）
可通过以下方式“唤醒”Activity 并传递打印指令：
发送带 FLAG_ACTIVITY_NEW_TASK | FLAG_ACTIVITY_CLEAR_TOP 的 PendingIntent；
使用 LocalBroadcastManager 或 LiveData 通知前台 Activity；
（Android 8.0+）通过 NotificationCompat.Builder 添加「打印」Action 按钮，点击后启动 Activity 并跳转至打印页。
⚠️ 注意事项：
❌ 不要尝试在 Service 中 new Activity() 或反射获取 Activity Context —— 违反 Android 架构原则，且大概率崩溃或被系统拦截；
❌ 避免使用 getApplicationContext() 或 getBaseContext() 调用 PrintManager.print()，它们均不满足 Activity Context 要求；
✅ 若使用 PdfDocumentAdapter，请确保其 onWrite() 方法中正确处理分页与流关闭（参考官方
PdfDocument
文档）；
✅ Android 11+ 还需注意存储访问权限：若 PDF 存于私有目录（如 getFilesDir()），需通过 FileProvider 提供 URI；若存于公共目录（如 Environment.DIRECTORY_DOCUMENTS），需申请 MANAGE_EXTERNAL_STORAGE（仅限特定用例）或改用 Storage Access Framework (SAF)。
? 总结：
Android 的打印 API 是 UI 绑定型（UI-bound）系统服务，其设计初衷就是由用户主动触发、全程参与。Service 的职责应聚焦于无界面任务（如下载、解析、监听），而打印作为最终呈现环节，必须交还给 Activity 处理。这一限制不是版本缺陷，而是自 Android 4.4（KitKat）引入打印框架以来一贯的设计契约，持续适用于所有后续版本（含 Android 13/14）。遵循此原则，才能保障兼容性、稳定性和合规性。
// 在 Activity 中（例如 MainActivity.java）
private void startPrint(String pdfPath) {
PrintManager printManager = (PrintManager) getSystemService(Context.PRINT_SERVICE);
PrintDocumentAdapter adapter = new PdfDocumentAdapter(pdfPath);
String jobName = getString(R.string.app_name) + "_document";
// 注意：必须使用 Activity 的 Context（即 this）
printManager.print(jobName, adapter, new PrintAttributes.Builder().build());
}