If you're working with ColdFusion 10's new REST implementation and experiencing 404 errors with Apache when trying to call your services, chances are your server is misconfigured. See this blog post for a complete step-by-step on how to configure multiple instances of ColdFusion 10 with Apache virtual hosts. It's relevant even if you only have a single instance of ColdFusion 10.

To the specific problem at hand, is how ColdFusion 10 and Tomcat handle mappings between services such as REST and ColdFusion (Tomcat) instances. There's a properties file called uriworkermap.properties that handles this:

view plain print about
1/cfformgateway/* = cfusion
2/CFFormGateway/* = cfusion
3/flex2gateway/* = cfusion
4/flex2gateway = cfusion
5/cffileservlet/* = cfusion
6/CFFileServlet/* = cfusion
7/cfform-internal/* = cfusion
8/flashservices/gateway/* = cfusion
9/flex-internal/* = cfusion
10/rest/* = cfusion
11/*.cfml/* = cfusion
12/*.mxml = cfusion
13/*.as = cfusion
14/*.cfm = cfusion
15/*.cfm/* = cfusion
16/*.swc = cfusion
17/*.cfml = cfusion
18/*.cfc = cfusion
19/*.cfc/* = cfusion
20/*.cfr = cfusion
21/*.cfswf = cfusion
22/*.sws = cfusion
23/*.jsp = cfusion
24/*.hbmxml = cfusion

What you can see here is all the mappings between the various ColdFusion services and the default cfusion instance. The crux of the issue is that you must explicitly declare the uriworkermap.properties file in each Apache virtual host, including the default via a directive called JkMountFile. It looks like this:

view plain print about
1JkMountFile "C:\ColdFusion10\config\wsconfig\1\uriworkermap.properties"

Here's an example of what that looks like for the default virtual host in Apache:

view plain print about
1# Load mod_jk module
2LoadModule jk_module "C:\ColdFusion10\config\wsconfig\1\mod_jk.so"
3# Where to find workers.properties
4JkWorkersFile "C:\ColdFusion10\config\wsconfig\1\workers.properties"
5# Where to put jk logs
6JkLogFile "C:\ColdFusion10\config\wsconfig\1\mod_jk.log"
7# Where to put jk shared memory
8JkShmFile "C:\ColdFusion10\config\wsconfig\1\jk_shm"
9# Set the jk log level [debug/error/info]
10JkLogLevel info
11# Select the timestamp log format
12JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
13
14AddHandler jakarta-servlet .cfm .cfml .cfc .cfr .cfswf
15
16<Files ~ ".hbmxml$">
17Order allow,deny
18Deny from all
19</Files>
20
21<VirtualHost *:80>
22ServerName localhost
23DocumentRoot C:/_web/cf10/cfusion/localhost/wwwroot
24ErrorLog c:/_web/logs/cfusion-localhost.log
25
26JkMountFile "C:\ColdFusion10\config\wsconfig\1\uriworkermap.properties"
27
28<Directory "C:/_web/cf10/cfusion/localhost/wwwroot">
29 Options Indexes FollowSymLinks
30 AllowOverride None
31 Order allow,deny
32 Allow from all
33</Directory>
34
35 Alias /CFIDE "C:\ColdFusion10\cfusion\wwwroot\CFIDE"
36
37 <Directory "C:\ColdFusion10\cfusion\wwwroot\CFIDE">
38 Options Indexes FollowSymLinks
39 AllowOverride None
40 Order allow,deny
41 Allow from all
42 </Directory>
43</VirtualHost>

Note that this is done in the mod_jk.conf file by default. This is the file that CF 10 creates and includes via your httpd.conf file by default. You don't have to use mod_jk.conf if you don't want to, but you must make sure that the various mod_jk directives are called and that JkMountFile is specified for each virtual host you setup.

Ensuring a JkMountFile directive for each virtual host should resolve the majority of your 404 errors when configuring ColdFusion 10 rest services with Apache.