Unit 08 · lesson
Diagnose Launch Failures
Launch adds configuration power and therefore new failure boundaries.
Package/executable not found
Use Unit 7 evidence:
ros2 pkg executables robotnix_pubsub
If the executable is not installed/discoverable, the launch file cannot start it.
Launch file not found in package
If direct file launch works but:
ros2 launch robotnix_pubsub student_system.launch.py
cannot find it, inspect the Python package data_files, rebuild, and source a clean overlay.
Node starts with unexpected name
Inspect:
ros2 node list
Then compare launch name/namespace configuration.
Both nodes start but no messages arrive
Inspect the resolved topic endpoints:
ros2 topic list -t
ros2 topic info <resolved_topic> --verbose
A remapping mismatch can separate a publisher and subscriber while both processes remain healthy.
Launch syntax/import error
Read the Python traceback or launch error. Do not diagnose a graph connection until the launch description itself loads.
Checkpoint
For one controlled launch failure, write:
Launch symptom:
Process evidence:
Graph evidence:
Configuration inspected:
Root cause:
Repair: