バージョンが合っていない
さまざまなソフトウェアを組み合わせるので、それぞれのバージョンが合っていないと、インストール時エラーあるいは実行時エラーになります。通常は最新の安定版を利用すれば大丈夫ですが、Mac OS X 10.4(Tiger)など古いOSを利用せざるを得ない場合は、それに合ったソフトウェアを見つけてくる必要があります。
gemを利用でファイルをダウンロードできない
プロキシサーバを経由してダウンロードする場合は、gemコマンドの前にあらかじめ、set http_proxy=http://xxx.xxx.xxx.xxx:xxxx
でプロキシを設定しておく必要があります。
MySQLに接続できない(Windowsの場合のみ)
<MySQLルート>¥bin¥libmysql.dllを<Rubyルート>¥binにコピーすると解消するかもしれません。MySQLに接続できない
MySQLは4.1から認証の方法が変わったようです。クライアントのバージョンがそれよりも古いと認証に失敗します。その場合、以下のOLD_PASSWORDを使用する方法で回避できます。
mysql>UPDATE user SET Password = OLD_PASSWORD('mypass') WHERE Host = 'some_host' AND User = 'some_user';
mysql>FLUSH PRIVILEGES;
mysql>FLUSH PRIVILEGES;
rakeタスクが失敗する
どんなrakeタスクでも失敗するなら、データベースに接続できていない可能性が高いです。ログを確認した上で、MySQLに接続できないを疑ってみる必要があります。インストールが失敗する(Mac/Linux)
あたりまえと言えばあたりまえですが、インストールには管理者権限が必要です。sudoで管理者として実行する必要があります。Windowsに慣れているとついつい忘れてしまいます。sudo gem install rails -y
など。