GD32V芯片下同一类实例多对象代码失效，复制重命名类则正常

我终于搞定了这个困扰我好几周的GD32V编译运行问题！问题根源是启动脚本与主源文件中的类名冲突，下面详细说说整个过程和解决思路：

问题背景 #

我基于hwlib库的hwlib::pin_out基类，自定义了一个同名的pin_out类用来抽象GPIO引脚输出：

• 单个实例调用write等方法完全正常
• 但只要实例化两个该类对象，代码就彻底无法运行
• 奇怪的是，把这个类复制并重命名为test_pin_out后，实例化两个不同类的对象，代码又能正常跑起来
• 而且这个问题只在O2、O3优化级别下出现，用O0时反而没毛病

代码细节与冲突分析 #

先贴出关键代码片段，方便理解问题：

hwlib提供的基类代码 #

// hwlib::pin_out类
class pin_out : public noncopyable {
public:
    /// @copydoc pin_in_out::write()
    virtual void write( bool x ) = 0;
    /// @copydoc pin_in_out::flush()
    virtual void flush() = 0;
};

// noncopyable类
class noncopyable {
public:
    noncopyable( const noncopyable& ) = delete;
    noncopyable& operator=( const noncopyable& ) = delete;
    constexpr noncopyable() {}
    // ~noncopyable() {} // somehow requires the heap??
};

自定义的同名pin_out类（出问题的版本） #

class pin_out : public hwlib::pin_out {
private:
    const pin_info_type & myPin;
    bool status;
public:
    pin_out(pins pin_number) : myPin(pin_info_array[(int)pin_number]){
        rcu_periph_clock_enable(myPin.enable_register);
        gpio_init(myPin.port, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, myPin.pin);
        gpio_bit_reset(myPin.port, myPin.pin);
        status=0;
    }
    void write(bool x){
        if(x){
            status=1;
            gpio_bit_set(myPin.port, myPin.pin);
        }else{
            gpio_bit_reset(myPin.port, myPin.pin);
            status=0;
        }
    }
    void flush(){ /* Empty */ }
    void toggle(){ status=!status; write(status); }
};

重命名后的test_pin_out类（正常运行版本） #

class test_pin_out{
private:
    const pin_info_type & myPin;
public:
    test_pin_out(pins pin_number) : myPin(pin_info_array[(int)pin_number]){
        rcu_periph_clock_enable(myPin.enable_register);
        gpio_init(myPin.port, GPIO_MODE_OUT_PP, GPIO_OSPEED_50MHZ, myPin.pin);
        gpio_bit_reset(myPin.port, myPin.pin);
    }
    void write(bool x){
        if(x){
            gpio_bit_set(myPin.port, myPin.pin);
        }else{
            gpio_bit_reset(myPin.port, myPin.pin);
        }
    }
};

验证用的主函数 #

#include "hwlib.hpp"
int main(void) {
    hwlib::target::pin_out pin1 = hwlib::target::pin_out(hwlib::target::pins::led_blue);
    hwlib::target::test_pin_out pin2 = hwlib::target::test_pin_out(hwlib::target::pins::led_green);
    while(true){
        pin1.write(1);
        pin2.write(1);
    }
    return 0;
}

核心原因拆解 #

在高优化级别（O2/O3）下，编译器和链接器会做很多符号合并、优化的操作。我的自定义类和hwlib的基类同名都是pin_out，再加上GD32V厂商提供的启动脚本中恰好存在同名的符号（或者类似的符号解析冲突），导致当实例化多个对象时，链接器无法正确区分不同的符号引用，最终导致代码运行时的内存布局错乱、方法调用地址错误，表现为代码无法正常运行。

而把类重命名为test_pin_out后，符号名变得唯一，链接器能正确解析每个类的符号，自然就没有问题了。

后续建议 #

• 嵌入式开发中，尽量避免自定义类/函数和依赖库、厂商SDK中的名称重复，尤其是在启用高优化级别时，符号冲突的问题会更隐蔽
• 遇到仅在特定优化级别下出现的运行故障，优先排查符号命名冲突、内存布局优化导致的越界这类问题
• 可以通过查看编译后的.map文件，分析符号的引用情况，快速定位冲突点

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