GH-48268: [C++][Acero] Enhance the type checking for hash join residual filter

GH-48268: [C++][Acero] Enhance the type checking for hash join residual filter #23218