本文定位：Dify 集成 / Java 后端 / AI 平台工程化示例环境：Dify 1.x 思路、Java 21、Spring Boot 3.3、PostgreSQL 16、Redis 7。Dify API 与页面配置会随版本变化，部署前请以目标版本文档为准。摘要Dify 的知识库、工作流和 Agent 能够快速把一个 AI Demo 搭出来，但企业系统不能把“工作流页面能运行”直接等同于“业务已经接入”。一旦 Dify 被嵌入工单、客服、合同或故障诊断系统，就需要解决用户身份传递、租户隔离、接口幂等、长任务回调、流式输出、错误重试和审计追踪。本文采用“Dify 负责模型编排，Java 负责业务边界”的方式，设计一条稳定的集成链路。重点讲清楚哪些逻辑适合放在 Dify，哪些逻辑必须回到 Java 服务；同时给出同步调用、流式调用、异步任务和回调处理的代码骨架。一、职责边界先划清能力更适合放在 Dify更适合放在 JavaPrompt 与模型选择是可提供配置管理文档检索与回答编排是负责权限数据提供订单、工单、用户状态变更