ROS2 Jazzy下SLAM定位模式无法加载地图文件求助

错误信息 #

serialization::Read: Failed to open requested file: /home/<user>/map/map.yaml. 
 DeserializePoseGraph: Failed to read file: /home/<user>/map/map.yaml.

当前slam_toolbox配置 #

slam_toolbox:
  ros__parameters:

    # Plugin params
    solver_plugin: solver_plugins::CeresSolver
    ceres_linear_solver: SPARSE_NORMAL_CHOLESKY
    ceres_preconditioner: SCHUR_JACOBI
    ceres_trust_strategy: LEVENBERG_MARQUARDT
    ceres_dogleg_type: TRADITIONAL_DOGLEG
    ceres_loss_function: None

    # ROS Parameters
    odom_frame: odom
    map_frame: map
    base_frame: body_link
    scan_topic: /scan
    use_map_saver: true
    mode: localization
    map_file_name: /home/<user>/map/map.yaml
    map_start_pose: [0.0, 0.0, 0.0]

文件权限与存在性确认 #

drwxrwxr-x  2 <user> <usergroup>  4096 Jul  4 16:39 ./
drwxrwxr-x 15 <user> <usergroup>  4096 Jul 11 01:26 ../
-rw-rw-rw-  1 <user> <usergroup> 87752 Jul  2 02:37 map.pgm
-rw-rw-rw-  1 <user> <usergroup>   159 Jul  4 16:36 map.yaml

map.yaml文件内容 #

image: "/home/<user>/map/map.pgm"
mode: trinary
resolution: 0.1
origin: [-19.2, -11.2, 0]
negate: 0
occupied_thresh: 0.65
free_thresh: 0.25

排查与解决思路 #

• 替换占位符为实际用户名：确保配置文件中的<user>已替换成系统真实用户名，比如你的用户名为ubuntu，路径需改为/home/ubuntu/map/map.yaml，不能保留占位符。
• 验证路径绝对正确性：在终端执行ls /home/<真实用户名>/map/map.yaml，确认文件存在；检查路径是否有拼写错误（大小写、空格、特殊字符）。
• 确认地图文件格式匹配：slam_toolbox定位模式需要读取自身保存的完整地图文件组合（.pgm+.yaml+.db3姿态图数据库），而非仅map_server生成的.yaml+.pgm。如果是其他工具生成的地图，需改用map_server加载静态地图配合AMCL做定位，或用slam_toolbox的map_saver重新保存地图。
• 检查进程访问权限：如果通过launch文件启动节点，确认启动进程的用户有权限访问目标路径；若用root启动，可能触发SELinux/AppArmor限制，尝试用当前用户重新启动。
• 校验yaml语法合法性：用yamllint /home/<user>/map/map.yaml检查文件语法，确保引号为英文双引号"、缩进格式正确。
• 尝试简化路径：将地图文件移至更简单的路径（如~/map/），配置文件中使用map_file_name: ~/map/map.yaml或相对路径，测试是否能正常读取。

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