本文详解如何正确构建以 DenseNet121 为视觉主干、融合 CSV 手工特征的双输入回归模型，重点解决 ValueError: Layer expects 2 input(s), but received 1 这一常见报错，并提供基于 tf.data.Dataset 的高效、可复现数据管道实现方案。

本文详解如何正确构建以 densenet121 为视觉主干、融合 csv 手工特征的双输入回归模型，重点解决 `valueerror: layer expects 2 input(s), but received 1` 这一常见报错，并提供基于 `tf.data.dataset` 的高效、可复现数据管道实现方案。

在构建多模态深度学习模型（如图像 + 结构化特征联合建模）时，一个典型且易错的陷阱是：模型定义为双输入（[image_input, features_input]），但训练时仍沿用单输入生成器（如 ImageDataGenerator.flow_from_dataframe）——这正是原代码中 ValueError: Layer "model" expects 2 input(s), but it received 1 input tensors 的根本原因。ImageDataGenerator 仅支持单一输入（图像），无法同步供给图像张量与手工特征向量。解决方案不是修补生成器，而是全面迁移到更灵活、更现代的 tf.data.Dataset API。

✅ 正确的数据管道：双输入 Dataset 构建

tf.data.Dataset 允许我们显式构造形如 (((batch_of_images), (batch_of_features)), batch_of_labels) 的嵌套结构，完美匹配双输入模型签名。关键在于使用 .map() 将原始路径/特征/标签三元组，映射为 (inputs, labels) 二元组，其中 inputs 是包含图像和特征的元组：

import tensorflow as tf
import numpy as np
import pandas as pd

# 假设已获取对齐的文件名列表、特征数组和标签数组
# train_filenames: List[str], train_features: np.ndarray (N, F), train_labels: np.ndarray (N,)

# 1. 创建基础 Dataset（三元组）
train_ds = tf.data.Dataset.from_tensor_slices((
    train_filenames,
    train_features,
    train_labels
))

# 2. 映射：读取图像 + 组合输入
def load_and_preprocess(path, features, label):
    # 读取并解码图像（自动推断格式）
    image = tf.io.read_file(path)
    image = tf.image.decode_image(image, channels=3)  # 确保 RGB
    image = tf.cast(image, tf.float32)

    # 调整大小（必须与模型 input_shape 一致！）
    image = tf.image.resize(image, [224, 224])  # ⚠️ DenseNet121 官方推荐尺寸

    # DenseNet 预处理：期望 [0, 255] 输入，非 [0, 1]
    image = tf.keras.applications.densenet.preprocess_input(image)

    return (image, features), label

train_ds = train_ds.map(
    load_and_preprocess,
    num_parallel_calls=tf.data.AUTOTUNE
)

# 3. 优化流水线（顺序至关重要！）
train_ds = train_ds.cache() \
                 .shuffle(buffer_size=10000, reshuffle_each_iteration=True) \
                 .batch(32) \
                 .prefetch(tf.data.AUTOTUNE)

# 验证集/测试集同理（无需 shuffle）
val_ds = tf.data.Dataset.from_tensor_slices((val_filenames, val_features, val_labels)) \
    .map(load_and_preprocess) \
    .batch(32) \
    .cache() \
    .prefetch(tf.data.AUTOTUNE)

⚠️ 关键注意事项：

• 尺寸一致性：DenseNet121 默认输入为 (224, 224, 3)。若强制使用 (75, 200)，可能因底层卷积核不兼容导致训练不稳定或性能下降。建议统一调整至 224×224。
• 预处理规范：densenet.preprocess_input() 内部执行 x[..., ::-1]（BGR转换）和均值减法，要求输入为 [0, 255] 整数范围。因此，ImageDataGenerator.rescale=1./255 必须移除，否则会双重归一化。
• 增强即插即用：避免 ImageDataGenerator，改用 Keras 预处理层（如 RandomFlip, RandomRotation），它们可无缝集成进模型图，且在 validation/test 模式下自动禁用：

# 在模型构建阶段添加增强层（仅训练时生效）
data_augmentation = tf.keras.Sequential([
    tf.keras.layers.RandomFlip("horizontal"),
    tf.keras.layers.RandomRotation(0.2),
    tf.keras.layers.RandomTranslation(0.1, 0.1),
])

# 在模型中应用（注意：仅在 training=True 时激活）
image_input = Input(shape=(224, 224, 3))
augmented_image = data_augmentation(image_input, training=True)
preprocessed_image = tf.keras.applications.densenet.preprocess_input(augmented_image)

✅ 模型构建与训练：端到端整合

完成数据管道后，模型定义保持不变，但训练调用方式彻底更新：

# 模型定义（保持原逻辑，仅修正 input_shape）
base_model = DenseNet121(
    include_top=False, 
    weights='imagenet', 
    input_shape=(224, 224, 3)  # ✅ 与 Dataset 输出尺寸严格一致
)
base_model.trainable = False

image_input = Input(shape=(224, 224, 3))
features_input = Input(shape=(train_features.shape[1],))

# 图像分支（含增强与预处理）
x_img = data_augmentation(image_input, training=True)
x_img = tf.keras.applications.densenet.preprocess_input(x_img)
x_img = base_model(x_img, training=False)
x_img = GlobalAveragePooling2D()(x_img)

# 特征拼接与回归头
x = Concatenate()([x_img, features_input])
x = Dropout(0.5)(x)
x = Dense(128, activation='relu')(x)
x = Dropout(0.5)(x)
output = Dense(1, activation='linear')(x)

model = Model(inputs=[image_input, features_input], outputs=output)
model.compile(optimizer=Adam(1e-3), loss='mse')

# ✅ 使用 Dataset 直接训练（无需 steps_per_epoch）
history = model.fit(
    train_ds,
    validation_data=val_ds,
    epochs=50,
    callbacks=[
        tf.keras.callbacks.EarlyStopping(patience=5, restore_best_weights=True)
    ]
)

# 评估
test_loss = model.evaluate(test_ds, verbose=0)
print(f"Test MSE: {test_loss:.4f}")

? 总结：避坑清单

问题	正确做法
双输入模型单输入喂给 fit()	彻底弃用 ImageDataGenerator，改用 tf.data.Dataset 构建 ((img, feat), label) 结构
图像尺寸与 DenseNet 不匹配	强制统一为 (224, 224, 3)；若需小尺寸，应微调 include_top=False 后接自适应池化
错误应用 rescale=1./255	移除所有 rescale，由 preprocess_input() 统一处理 [0,255] → 标准化
数据流水线低效	严格遵循 cache → shuffle → batch → prefetch 顺序，prefetch 放在最后以预加载批次
验证/测试集引入数据泄露	shuffle() 仅用于训练集；cache() 可选用于验证集，测试集通常不缓存

通过以上重构，您将获得一个健壮、高效、符合 TensorFlow 最佳实践的混合回归模型——它不仅能解决报错，更能为后续迁移学习、特征重要性分析及生产部署奠定坚实基础。