C++中按引用传递的数组未更新问题排查

你的修改丢失有两个核心原因：

1. 类成员是值拷贝而非引用 #

你的RequestHandler类中，私有成员motorArray_是std::array<Motor, NOF_MOTORS>的值类型实例，不是引用类型。即使构造函数按引用接收参数，初始化列表motorArray_(motorArray)做的是完整的数组拷贝——类内部修改的只是这份拷贝，和外部原数组完全无关，自然外部看不到任何变化。

2. 原数组是局部变量，生命周期过短 #

setup()里的motorArray是局部变量，setup()执行完毕后，这个数组会被销毁。就算你把类成员改成引用，后续RequestHandler操作时会访问悬空引用，触发未定义行为（大概率程序崩溃或数据乱码）。

解决方法 #

方法一：使用全局数组（Arduino场景最常用） #

把数组移到全局作用域，确保其生命周期覆盖整个程序运行期，同时让类持有数组的引用：

// 全局定义数组，程序运行期间始终存在
std::array<Motor, NOF_MOTORS> motorArray = {
    Motor(1, 0, 1, DEFAULT_PWM),
    Motor(2, 2, 3, DEFAULT_PWM)
};

class RequestHandler : public AsyncWebHandler
{
public:
    // 构造函数接收数组引用
    RequestHandler(std::array<Motor, NOF_MOTORS>& motorArray) : motorArray_(motorArray) {}

private:
    // 成员变量定义为引用，必须在构造函数初始化列表初始化
    std::array<Motor, NOF_MOTORS>& motorArray_;

    // 后续处理请求时，直接修改motorArray_就会同步到全局数组
};

void setup()
{
    server.addHandler(new RequestHandler(motorArray));
}

方法二：使用堆分配数组（避免全局变量） #

用new在堆上创建数组，类持有指针，确保数组生命周期长于RequestHandler：

class RequestHandler : public AsyncWebHandler
{
public:
    // 构造函数接收数组指针
    RequestHandler(std::array<Motor, NOF_MOTORS>* motorArrayPtr) : motorArrayPtr_(motorArrayPtr) {}

private:
    std::array<Motor, NOF_MOTORS>* motorArrayPtr_;

    // 修改时通过指针访问，例如：
    // motorArrayPtr_->at(0).setPwm(100);
};

void setup()
{
    // 堆上分配数组，直到手动delete才会销毁（Arduino重启会自动清理）
    auto motorArray = new std::array<Motor, NOF_MOTORS>{
        Motor(1, 0, 1, DEFAULT_PWM),
        Motor(2, 2, 3, DEFAULT_PWM)
    };

    server.addHandler(new RequestHandler(motorArray));
}

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