xdebug remote debugging won’t stop at breakpoints

I had this problem and took me ages to find the answer.

In your debug config, in the server area, click Configure, go to Path Mapping, click the path that’s there and click edit, change to Path in file system and navigate to the correct file.

Done.