LangBot项目接入Dify服务时301错误的解决方案

问题现象

在使用LangBot项目(v3.4.13)接入Dify服务(v1.1.3)时，开发者遇到了API调用失败的问题。错误日志显示为"DifyAPIError 301"，并伴随HTML格式的错误响应。这表明客户端请求被重定向，但未能正确处理重定向响应。

错误原因分析

301状态码在HTTP协议中表示永久重定向。当LangBot向Dify服务发送API请求时，服务端返回了重定向响应，但客户端未能正确处理这一情况。这通常由以下原因导致：

1. 基础URL配置错误：在provider.json配置文件中，base-url字段可能包含了错误的API端点路径
2. API版本不匹配：配置中使用了/v1路径，但实际服务可能使用了不同的版本路径
3. HTTPS/HTTP协议不匹配：服务端可能强制使用HTTPS，而客户端配置使用了HTTP

解决方案

正确的base-url配置

根据Dify服务的实际部署情况，base-url应配置为服务实例运行的服务器请求地址。例如：

"base-url": "https://dify.xxx.com/api"

而不是包含版本路径/v1的地址。这是因为Dify服务通常在/api路径下提供API端点，版本控制可能通过其他方式实现。

API密钥的正确获取

api-key应从实际运行的Dify服务请求中获取，具体方法为：

1. 在浏览器中访问Dify服务的Web界面
2. 打开开发者工具(通常按F12)
3. 找到任意一个API请求
4. 查看请求头中的Authorization字段
5. 提取其中的Bearer token作为api-key

配置示例

正确的provider.json配置示例：

{
    "dify-service-api": {
        "agent": {
            "api-key": "app-实际密钥",
            "timeout": 120
        },
        "app-type": "chat",
        "base-url": "https://dify.xxx.com/api",
        "chat": {
            "api-key": "app-实际密钥",
            "timeout": 120
        },
        "options": {
            "convert-thinking-tips": "original"
        },
        "workflow": {
            "api-key": "app-实际密钥",
            "output-key": "summary",
            "timeout": 120
        }
    },
    "runner": "dify-service-api"
}

验证步骤

1. 修改provider.json配置文件后，重启LangBot服务
2. 发送测试消息，如"who are you"
3. 检查日志中是否仍有301错误
4. 如果问题仍然存在，检查网络连接和Dify服务状态

总结

正确配置Dify服务集成需要注意两个关键点：准确的基础URL地址和有效的API密钥。开发者应确保从实际运行的Dify服务中获取这些信息，而不是使用示例或占位符值。通过正确的配置，LangBot可以顺利与Dify服务建立连接，实现智能对话功能。