You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Sphinx执行make confluence推送文档至Confluence认证失败如何解决

Sphinx连接Confluence认证失败解决方案
  • 修正服务地址配置
    你当前conf.py中的confluence_server_url参数错误添加了/spaces后缀,sphinxcontrib.confluencebuilder要求填写Confluence服务的根路径,无需拼接空间相关的路径后缀,修改后的配置参考:
# 仅保留/wiki/结尾的根路径即可,不要加/spaces等后续路径
confluence_server_url = 'https://<你的实例名>.atlassian.net/wiki/'
# Confluence Cloud版本必须填写完整的Atlassian账号邮箱,不能使用短用户名
confluence_server_user = '<你的账号邮箱>'
# 此处填写你生成的API令牌,不要填账号的登录密码
confluence_server_pass = '<你的API令牌>'
  • 确认账号权限
    确认你使用的账号对配置的Documentation空间有页面创建、编辑权限,如果是企业托管的Confluence实例,联系管理员确认账号没有被限制API访问权限。
  • 排查详细错误信息
    如果修改配置后仍然报错,可以执行带调试参数的构建命令,查看更详细的错误日志定位问题:
    make confluence SPHINXOPTS="-v"

内容的提问来源于stack exchange,提问作者Divyank

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.28 14:24:05