这个错误： ``` [ERROR] 附件操作异常: local variable 'existing_attachment' referenced before assignment ``` 是 **Python 的经典运行时错误**：`UnboundLocalError`，意思是： > ✅ 你在某个作用域（比如函数内部）**尝试读取一个变量 `existing_attachment` 的值**， > ❌ 但 **该变量在当前分支中可能根本没被赋值过** —— 即：**存在某条执行路径，跳过了它的定义**。 --- ### 🔍 错误原因详解（结合你的上下文） 你很可能写了类似这样的逻辑（常见于“查询 → 有则用，无则插”场景）： ```python def attachment(self): # ... 数据库连接等 ... query.prepare("SELECT attachment FROM detail WHERE ...") query.exec_() if query.next(): existing_attachment = query.value(0) # ✅ 赋值了 # ❌ 没有 else 分支！如果 query.next() 为 False，existing_attachment 根本没定义！ # 后面却用了它： QDesktopServices.openUrl(QUrl.fromLocalFile(existing_attachment)) # ⚠️ 这里报错！ ``` ✅ 当 `query.next()` 返回 `True`（查到记录）→ `existing_attachment` 被赋值 → 正常运行。 ❌ 当 `query.next()` 返回 `False`（没查到）→ `existing_attachment` **从未被创建** → 后续引用就触发 `UnboundLocalError`。 > 💡 Python 规则：**只要一个变量在函数内任何位置被赋值（`=`），它就被视为“局部变量”**；即使赋值语句在 `if` 里，只要存在未执行的分支，该变量在其他地方引用就会报错。 --- ### ✅ 正确写法：确保变量**在所有分支中都被初始化** #### ✅ 方案 1：显式初始化为 `None`（推荐，语义清晰） ```python existing_attachment = None # ✅ 提前声明，默认值 if query.next(): existing_attachment = query.value(0) if not isinstance(existing_attachment, str) or not existing_attachment.strip(): raise ValueError("数据库 attachment 字段为空") # 后续统一判断 if existing_attachment: QDesktopServices.openUrl(QUrl.fromLocalFile(existing_attachment)) else: # 插入新记录，并设 existing_attachment = folder_path query.prepare("INSERT INTO ... VALUES (?, ?, ?, ?)") query.addBindValue(...) query.exec_() existing_attachment = folder_path show_toast("✅ 首次创建...") # 最终打开（此时 existing_attachment 必然有值） if existing_attachment and os.path.isdir(existing_attachment): QDesktopServices.openUrl(QUrl.fromLocalFile(existing_attachment)) else: raise OSError(f"无效附件路径: {existing_attachment}") ``` #### ✅ 方案 2：用 `else` 显式覆盖（更紧凑） ```python if query.next(): existing_attachment = query.value(0) else: # 插入新记录 query.prepare("INSERT INTO ...") query.exec_() existing_attachment = folder_path # ✅ 所有分支都赋值了 show_toast("✅ 首次创建...") # 此处 existing_attachment 必定已定义 QDesktopServices.openUrl(QUrl.fromLocalFile(existing_attachment)) ``` > ✅ 这种写法逻辑更线性，且避免 `None` 判断，**强烈推荐用于你的场景**（因为“不存在”就插入，“存在”就取出，二者必居其一）。 --- ### 🧪 为什么 `print(folder_path)` 没报错，但 `existing_attachment` 报错了？ - `folder_path` 是在函数开头就定义的（`folder_path = os.path.join(...)`），属于**确定赋值**； - `existing_attachment` 是在 `if` 内部才定义的，**没有兜底** → Python 编译器检测到“可能未定义”，运行时报错。 --- ### ✅ 如何快速定位和修复？（Debug 步骤） 1. **搜索整个文件**：查找 `existing_attachment =` 和 `existing_attachment` 的所有出现位置； 2. **确认是否所有 `if/elif/else` 分支都给它赋值了**； 3. **加一行调试打印**（临时）： ```python print(f"[DEBUG] query.next() = {query.next()}, type={type(query.value(0)) if query.next() else 'N/A'}") ``` 4. **用 IDE 调试**：在 `query.next()` 行打断点，观察是否进入 `if` 分支。 --- ### ✅ 完整修复示例（整合进你的原逻辑） ```python # ✅ 替换你原来的查询+插入块为以下健壮版本： query.prepare("SELECT attachment FROM detail WHERE item_id = ? AND item_name = ? AND source_level = ?") query.addBindValue(self.item_id) query.addBindValue(self.item_name) query.addBindValue(self.source_level) if not query.exec_(): raise RuntimeError(f"查询失败: {query.lastError().text()}") # ✅ 关键：用 else 确保 existing_attachment 必有值 if query.next(): existing_attachment = query.value(0) if not isinstance(existing_attachment, str) or not existing_attachment.strip(): raise ValueError(f"数据库中 attachment 无效: {repr(existing_attachment)}") show_toast(f"📁 已存在，打开数据库记录的附件目录：{os.path.basename(existing_attachment)}") else: # ✅ 不存在 → 插入 insert_q = QSqlQuery(db) insert_q.prepare("INSERT INTO detail (item_id, item_name, source_level, attachment) VALUES (?, ?, ?, ?)") insert_q.addBindValue(self.item_id) insert_q.addBindValue(self.item_name) insert_q.addBindValue(self.source_level) insert_q.addBindValue(folder_path) if not insert_q.exec_(): raise RuntimeError(f"插入失败: {insert_q.lastError().text()}") existing_attachment = folder_path show_toast(f"✅ 首次创建，附件目录已保存：{os.path.basename(folder_path)}") # ✅ 统一打开（此时 existing_attachment 必不为 None） if not os.path.isdir(existing_attachment): raise OSError(f"附件路径不存在或非目录：{existing_attachment}") QDesktopServices.openUrl(QUrl.fromLocalFile(existing_attachment)) ``` ---