报错 issue_prefix 为空？别被 bd bootstrap 的成功提示骗了

在 AI Agent 开发圈子里，Beads (bd) 被誉为“有灵魂的任务追踪器”，因为它能把任务变成图。但当你高高兴兴地执行完官方推荐的 bd bootstrap，并看到控制台跳出 Success! 的绿字后，接着运行 bd create，现实会狠狠给你一记耳光：

{ "error": "数据库未初始化：缺少 issue_prefix 配置……" }

作为一个整天和底层架构打交道的架构师，我见过太多被这个“成功假象”坑得怀疑人生的开发者。你以为你初始化成功了，其实 Beads 的状态机正处于一种极度尴尬的“半熟”状态。

💡 报错现象总结：执行 bd bootstrap 或 bd config set issue_prefix 后，bd config show 显示正常，但 bd create 依然报错提示缺少前缀。本质原因是配置未被成功写入数据库的作用域（Database Scope），而仅仅停留在临时的 config.yaml 或内存缓存中。

---

配置源的“多重人格”：为什么 show 和 get 会打架？

在 Beads 的逻辑里，配置不是存在一个地方，而是存在三个地方：环境变量、本地 config.yaml、以及 Dolt 数据库内部表。

绝大多数报错的根源在于：bd config show 往往展示的是三个源合并后的结果（看上去很美），而 bd create 这类写操作，则会对数据库内部的状态进行“严格检查”。如果数据库表里的 issue_prefix 字段是 <nil>，哪怕你的配置文件里写了一万遍 la-，底层逻辑也会判定为“未初始化”。

状态矛盾分析：官方修复方案的“失效”现场

命令表现	结果输出	实际状态	架构师深度剖析
bd bootstrap	Success!	数据库字段依然为空	只完成了外壳同步，未触发底层写入
bd config show	issue_prefix: la-	显示正常	读取的是配置文件源，具有误导性
bd config get	<nil>	真实状态暴露	直接读取数据库作用域，这是命令失败的真凶
bd create	FAILED	阻塞运行	严格检查器只认数据库内的持久化状态

这种“三权分立”却没有良好同步的架构，是导致开发者在 Issue 列表里疯狂刷屏的主因。

---

源码排雷：解析严格检查器（Strict Checker）的硬核逻辑

如果你去翻 Beads 的源码，你会发现它在执行创建任务前，会调用一个内部的 CheckInitialized 函数。

// 模拟 Beads 内部的初始化校验逻辑片段
func (c *App) CheckInitialized() error {
    // 痛点：它直接从数据库连接对象中获取元数据
    prefix := c.db.GetMetadata("issue_prefix")
    if prefix == "" || prefix == "<nil>" {
        // 即使 config.yaml 有值，这里依然会抛出致命错误
        return fmt.Errorf("database not initialized: missing issue_prefix")
    }
    return nil
}

由于 bd config set 在早先版本中并不具备向数据库作用域“穿透写入”的能力，导致你设置的配置仅仅是浮在表面的“贴纸”，没有真正刻进数据库的“骨髓”里。

---

痛苦的临时方案：为何“反复修改 config.yaml”是浪费时间？

很多开发者的第一反应是去改 .beads/config.yaml。你改了，重启了，甚至给文件加了只读权限，但 bd create 依然报错。

这是因为：

1. 优先级陷阱：数据库作用域的配置优先级在某些操作中高于本地文件。
2. 状态锁死：一旦 bootstrap 的标志位在数据库里被错误标记，普通的配置修改命令无法强行覆写它。
3. 环境隔离：如果你在 Docker 或远程模式下运行，本地文件的修改甚至根本传不到服务器端的数据库实例中。

---

强制重刷数据库作用域的“终极解药”

别再被 bootstrap 牵着鼻子走了。要解决这个顽疾，必须使用“重锤”强行将前缀同步进数据库。

与其浪费时间去研究配置优先级，不如直接使用我为你准备的初始化报错一键修复脚本。这套方案采用了 bd init --reinit-local 结合显式 API 路径的策略，能够绕过不靠谱的 bootstrap 逻辑，直接通过 maintainer 角色权限将 issue_prefix 强行打入数据库底层。

让配置真正生效，而不是停留在纸面上。 这种针对“配置源冲突”的深度修正方案，能让你在 10 秒内恢复生产力。你可以直接前往 GitCode 领取这个修复补丁，彻底告别那些无效的成功提示。

[点击前往 GitCode 领取“初始化报错一键修复脚本”]