Go开发Trello克隆：卡片迁移后SQLite存储异常排查

针对卡片跨看板迁移时数据库更新异常的问题，从以下几个方向逐一排查：

1. 确认SQL语句与参数绑定的一致性 #

检查代码中UpdateCardParentSql常量的实际内容是否与你贴出的SQL一致：

UPDATE cards
    SET board_id = $2
    WHERE id = $1
    RETURNING *;

你的Go函数中stmt.Exec(id, boardId)对应$1=卡片ID、$2=目标看板ID，逻辑是正确的。但如果实际代码中SQL写反了$1和$2，就会导致board_id被错误设置为卡片ID，引发异常。可以直接打印UpdateCardParentSql的内容确认。

2. 检查更新操作的实际影响行数 #

修改UpdateCardParent函数，打印更新操作影响的行数，确认是否真的命中了目标卡片：

func UpdateCardParent(id int64, boardId int64) sql.Result {
    stmt, err := DB.Prepare(UpdateCardParentSql)
    if err != nil {
        logger.Error.Fatal(ErrCreatSQLstmt, err)
    }
    defer stmt.Close() // 新增：及时关闭stmt避免资源泄漏
    res, err := stmt.Exec(id, boardId)
    if err != nil {
        logger.Error.Fatal(ErrExecSQLstmt, err)
    }
    rowsAffected, _ := res.RowsAffected()
    logger.Info.Printf("更新卡片ID:%d，实际影响行数:%d", id, rowsAffected)
    return res
}

如果行数为0，说明传入的卡片ID在数据库中不存在，或者存在未被注意的过滤逻辑（比如软删除标记），需要核对卡片ID的有效性。

3. 排查事务与数据同步问题 #

如果卡片迁移涉及多个操作（比如从原看板移除、插入目标看板、更新board_id），必须确保这些操作在同一个事务中执行，避免部分操作成功导致数据不一致。示例代码：

tx, err := DB.Begin()
if err != nil {
    // 处理事务启动错误
}
defer tx.Rollback()

// 执行：从原看板的链表中移除卡片
// 执行：插入目标看板的指定位置
// 执行：更新卡片的board_id

if err := tx.Commit(); err != nil {
    // 处理事务提交错误
}

另外，前端展示正常但数据库异常，可能是内存中的dll.DLL链表已更新，但数据库操作未成功，需要确认数据库更新操作是否在内存修改之后执行，且未被异常中断。

4. 检查缓存与数据读取逻辑 #

如果后端实现了内存缓存，更新数据库后需要同步更新缓存，否则后续读取的还是旧数据。特别是首次创建的卡片，可能缓存过期时间设置过长，导致始终读取旧的board_id。

5. 排查卡片位置维护逻辑 #

卡片位置错乱、越界的问题，大概率和看板内的排序逻辑相关：

• 确认迁移时是否正确将卡片从原看板的dll.DLL链表中移除，并插入到目标看板的指定位置；
• 检查是否仅靠内存链表维护顺序、未在数据库中存储位置字段，导致重启服务后位置丢失；
• 多并发场景下，是否存在位置更新的竞态条件，导致插入位置错误。

6. 手动验证SQL执行结果 #

直接在SQLite客户端执行更新语句，排除代码层面的问题：

UPDATE cards SET board_id = 目标看板ID WHERE id = 问题卡片ID;

查看执行结果是否符合预期，若手动执行正常，再回到Go代码排查参数传递、语句预处理的细节。

内容的提问来源于stack exchange，提问作者Anacardo