Tensorflow（Python）报错：尝试使用未初始化变量

嗨，作为TensorFlow老玩家，我太懂这种明明觉得变量都初始化了但还是报错的崩溃感了！尤其是和summary_ops相关的问题，很容易因为细节踩坑，咱们一步步来排查解决：

1. 先精准定位未初始化的变量 #

有时候光凭报错信息很难锁定问题，不如先打印出未初始化的变量列表，直接找到根源：

# 在你的代码中加入这段，运行后就能看到具体哪些变量没被初始化
uninitialized_vars = tf.report_uninitialized_variables()
with tf.Session() as sess:
    # 先执行你原本的初始化操作，再打印未初始化变量
    sess.run(tf.global_variables_initializer())
    print("未初始化的变量：", sess.run(uninitialized_vars))

通过变量名称就能快速判断——summary相关的变量通常会带有summary、scalar、histogram这类关键词。

2. 检查变量定义与初始化器的顺序 #

这是新手最容易踩的坑：先创建初始化器，再定义summary或其他变量。比如下面这段错误示例：

# ❌ 错误顺序：初始化器创建在前，summary和变量定义在后
init_op = tf.global_variables_initializer()
# 定义损失函数和summary
loss = tf.reduce_mean(tf.square(pred - y_true))
tf.summary.scalar("training_loss", loss)
merged_summary = tf.summary.merge_all()

with tf.Session() as sess:
    sess.run(init_op)  # 此时summary相关变量还没被加入初始化列表！
    sess.run(merged_summary)  # 必然报错未初始化变量

正确做法是先定义所有变量、操作、summary，最后再创建全局初始化器：

# ✅ 正确顺序：先定义所有内容，再创建初始化器
loss = tf.reduce_mean(tf.square(pred - y_true))
tf.summary.scalar("training_loss", loss)
merged_summary = tf.summary.merge_all()
# 此时初始化器会包含所有已定义的变量，包括summary内部创建的变量
init_op = tf.global_variables_initializer()

with tf.Session() as sess:
    sess.run(init_op)
    summary_data = sess.run(merged_summary)  # 正常执行

3. 单独初始化summary相关变量 #

如果代码结构没办法调整顺序，或者只想针对性初始化summary的变量，可以手动筛选后初始化：

# 筛选出名称包含"summary"的全局变量
summary_vars = [var for var in tf.global_variables() if "summary" in var.name.lower()]
# 创建summary变量的专属初始化器
init_summary_op = tf.variables_initializer(summary_vars)

with tf.Session() as sess:
    # 先初始化模型自身的变量
    sess.run(tf.global_variables_initializer())
    # 再初始化summary相关变量
    sess.run(init_summary_op)
    # 之后就能正常使用summary_ops了

4. 用MonitoredTrainingSession简化流程 #

如果觉得手动处理初始化太繁琐，TensorFlow提供了tf.train.MonitoredTrainingSession，它会自动帮你处理变量初始化、summary写入、checkpoint保存等一系列事情，新手友好度拉满：

merged_summary = tf.summary.merge_all()

with tf.train.MonitoredTrainingSession() as sess:
    global_step = 0
    while not sess.should_stop():
        # 执行训练步骤并获取summary数据
        _, summary_data = sess.run([train_op, merged_summary])
        # 写入summary到日志
        sess.summary_writer.add_summary(summary_data, global_step)
        global_step += 1

这个会话会自动初始化所有变量（包括summary相关的），不用你手动调用初始化器。

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